Last modified: December 2014

Jump to: Description · Examples · Bugs · See Also

AHELP for CIAO 4.16


Context: crates


Return an array of the column names in a crate.


get_col_names(crate, vectors=True, rawonly=True)


Argument Description
crate A Crate object such as a TABLECrate or IMAGECrate
vectors Should vector notation be used (True) or should individual component columns be included (False)?
rawonly Should virtual columns be excluded (True) or included (False)?

The get_col_names command returns an array of strings containing the names of the columns in the table crate. The format of these column names depends on the vectors and rawonly arguments.


Example 1

>>> cr = read_file("evt2.fits")
>>> cnames = get_col_names(cr)
>>> print(cnames)
['time' 'ccd_id' 'node_id' 'expno' 'chip(chipx,chipy)'
'tdet(tdetx,tdety)' 'det(detx,dety)' 'sky(x,y)'
'pha' 'energy' 'pi' 'fltgrade' 'grade' 'status']

Get the array of column names from the crate "cr". The default settings are used, so the output includes regular column names and vector column names in vector notation, but not virtual column names.

Example 2

>>> cnames = get_col_names(cr, vectors=False, rawonly=False)
>>> print(cnames)
['time' 'ccd_id' 'node_id' 'expno' 'chipx' 'chipy' 'tdetx' 'tdety'
'dety' 'x' 'y' 'pha' 'pha_ro' 'energy' 'pi' 'fltgrade' 'grade' 'status'

The column names are retrieved with the vector columns expanded (vectors=False) and virtual columns are included (rawonly=False).


See the bug pages on the CIAO website for an up-to-date listing of known bugs.

Refer to the CIAO bug pages for an up-to-date listing of known issues.

See Also

add_col, col_exists, copy_colvals, copy_piximgvals, delete_col, get_axis_transform, get_col, get_colvals, get_crate_item_type, get_crate_type, get_key, get_key_names, get_keyval, get_number_cols, get_number_rows, get_piximg, get_piximg_shape, get_piximgvals, get_transform, get_transform_matrix, is_virtual, set_colvals