astro py:docs

- Index
- Modules

### Navigation

- next »
- « previous |
- Astropy v1.1.1 »
- ASCII Tables (`astropy.io.ascii`) »
- read

# read

`astropy.io.ascii.``read`(table, guess=None, **kwargs)

  Read the input `table` and return the table. Most of the default behavior for various parameters is determined by the Reader class.

  Parameters:

  table : str, file-like, list

  > Input table as a file name, file-like object, list of strings, or single newline-separated string.

  guess : bool

  > Try to guess the table format (default= `True`)

  format : str, `BaseReader`

  > Input table format

  Inputter : `BaseInputter`

  > Inputter class

  Outputter : `BaseOutputter`

  > Outputter class

  delimiter : str

  > Column delimiter string

  comment : str

  > Regular expression defining a comment line in table

  quotechar : str

  > One-character string to quote fields containing special characters

  header_start : int

  > Line index for the header line not counting comment or blank lines. A line with only whitespace is considered blank.

  data_start : int

  > Line index for the start of data not counting comment or blank lines. A line with only whitespace is considered blank.

  data_end : int

  > Line index for the end of data not counting comment or blank lines. This value can be negative to count from the end.

  converters : dict

  > Dictionary of converters

  data_Splitter : `BaseSplitter`

  > Splitter class to split data columns

  header_Splitter : `BaseSplitter`

  > Splitter class to split header columns

  names : list

  > List of names corresponding to each data column

  include_names : list

  > List of names to include in output (default= `None` selects all names)

  exclude_names : list

  > List of names to exclude from output (applied after `include_names`)

  fill_values : dict

  > specification of fill values for bad or missing table values

  fill_include_names : list

  > List of names to include in fill_values (default= `None` selects all names)

  fill_exclude_names : list

  > List of names to exclude from fill_values (applied after `fill_include_names`)

  fast_reader : bool

  > Whether to use the C engine, can also be a dict with options which default to `False` (default= `True`)

  Reader : `BaseReader`

  > Reader class (DEPRECATED) (default= `Basic`).

  Returns:

  dat : `Table`

  > Output table