docstr: Given a collection of internal vertex ids, return a DataFrame of
  the external vertex ids
  
  Parameters
  ----------
  df: cudf.DataFrame, cudf.Series, dask_cudf.DataFrame, dask_cudf.Series
      A list of internal vertex identifiers that will be
      converted into external vertex identifiers.  If df is a series type
      object it will be converted to a dataframe where the series is
      in a column labeled 'id'.  If df is a dataframe type object
      then internal_column_name should identify which column corresponds
      the the internal vertex id that should be converted
  
  internal_column_name: string, optional (default=None)
      Name of the column containing the internal vertex id.
      If df is a series then this parameter is ignored.  If df is
      a DataFrame this parameter is required.
  
  external_column_names: string or list of str, optional (default=None)
      Name of the columns that define an external vertex id.
      If not specified, columns will be labeled '0', '1,', ..., 'n-1'
  
  drop: boolean, optional (default=False)
      If True the internal column name will be dropped from the
      DataFrame.
  
  Returns
  ---------
  df : cudf.DataFrame or dask_cudf.DataFrame
      The original DataFrame columns exist unmodified.  Columns
      are added to the DataFrame to identify the external vertex
      identifiers. If external_columns is specified, these names
      are used as the names of the output columns.  If external_columns
      is not specifed the columns are labeled '0', ... 'n-1' based on
      the number of columns identifying the external vertex identifiers.
docstr_tok: ["Given","a","collection","of","internal","vertex","ids",",","return","a","DataFrame","of","the","external","vertex","ids","Parameters","--","--","--","--","--","df",":","cudf.DataFrame",",","cudf.Series",",","dask_cudf.DataFrame",",","dask_cudf.Series","A","list","of","internal","vertex","identifiers","that","will","be","converted","into","external","vertex","identifiers",".","If","df","is","a","series","type","object","it","will","be","converted","to","a","dataframe","where","the","series","is","in","a","column","labeled","'id","'",".","If","df","is","a","dataframe","type","object","then","internal_column_name","should","identify","which","column","corresponds","the","the","internal","vertex","id","that","should","be","converted","internal_column_name",":","string",",","optional","(","default=None",")","Name","of","the","column","containing","the","internal","vertex","id",".","If","df","is","a","series","then","this","parameter","is","ignored",".","If","df","is","a","DataFrame","this","parameter","is","required",".","external_column_names",":","string","or","list","of","str",",","optional","(","default=None",")","Name","of","the","columns","that","define","an","external","vertex","id",".","If","not","specified",",","columns","will","be","labeled","'","0","'",",","'","1",",","'",",","...",",","'n-1'","drop",":","boolean",",","optional","(","default=False",")","If","True","the","internal","column","name","will","be","dropped","from","the","DataFrame",".","Returns","--","--","--","--","-","df",":","cudf.DataFrame","or","dask_cudf.DataFrame","The","original","DataFrame","columns","exist","unmodified",".","Columns","are","added","to","the","DataFrame","to","identify","the","external","vertex","identifiers",".","If","external_columns","is","specified",",","these","names","are","used","as","the","names","of","the","output","columns",".","If","external_columns","is","not","specifed","the","columns","are","labeled","'","0","'",",","...","'n-1","'","based","on","the","number","of","columns","identifying","the","external","vertex","identifiers","."]
code: def from_internal_vertex_id(
      self,
      df,
      internal_column_name=None,
      external_column_names=None,
      drop=False,
  ):
      """
      Given a collection of internal vertex ids, return a DataFrame of
      the external vertex ids
  
      Parameters
      ----------
      df: cudf.DataFrame, cudf.Series, dask_cudf.DataFrame, dask_cudf.Series
          A list of internal vertex identifiers that will be
          converted into external vertex identifiers.  If df is a series type
          object it will be converted to a dataframe where the series is
          in a column labeled 'id'.  If df is a dataframe type object
          then internal_column_name should identify which column corresponds
          the the internal vertex id that should be converted
  
      internal_column_name: string, optional (default=None)
          Name of the column containing the internal vertex id.
          If df is a series then this parameter is ignored.  If df is
          a DataFrame this parameter is required.
  
      external_column_names: string or list of str, optional (default=None)
          Name of the columns that define an external vertex id.
          If not specified, columns will be labeled '0', '1,', ..., 'n-1'
  
      drop: boolean, optional (default=False)
          If True the internal column name will be dropped from the
          DataFrame.
  
      Returns
      ---------
      df : cudf.DataFrame or dask_cudf.DataFrame
          The original DataFrame columns exist unmodified.  Columns
          are added to the DataFrame to identify the external vertex
          identifiers. If external_columns is specified, these names
          are used as the names of the output columns.  If external_columns
          is not specifed the columns are labeled '0', ... 'n-1' based on
          the number of columns identifying the external vertex identifiers.
      """
      tmp_df = None
      can_drop = True
      if type(df) is cudf.Series:
          tmp_df = df.to_frame("id")
          internal_column_name = "id"
          can_drop = False
      elif type(df) is dask_cudf.Series:
          tmp_df = df.to_frame("id")
          internal_column_name = "id"
          can_drop = False
      else:
          tmp_df = df
  
      output_df = self.implementation.from_internal_vertex_id(
          tmp_df, internal_column_name, external_column_names
      )
  
      if drop and can_drop:
          return output_df.drop(columns=internal_column_name)
  
      return output_df
  
file_path: cugraph/python/cugraph/cugraph/structure/number_map.py
imports: from collections.abc import Iterable
  import dask_cudf
  import numpy
  import cudf
  import warnings
label_desc: Use image node_id 7 for calling the NumberMap obj's underlying member method code with example usage: obj.from_internal_vertex_id(df, internal_column_name, external_column_names, drop) and returns: output_df, output_df