project - project columns from a starbase data table.

SYNOPSYS

project [-i input] [-o output] [options] [column] ...

DESCRIPTION

column reads a starbase data table from its standard input and prints a table with the columns given as arguments on its standard output. If a given column does not exist it is created in the output.

column and project are the same program.

OPTIONS

Program Options

-a
Output all the columns in the table. This is useful when adding columns to a table.
-b
Print only the body (rows) of the table.
-hv
Print out only the header values.
-hV
Print out only the header values as a value table.
-hl
Print out only the headline.
-hd
Print out only the dashline.
-i file
Read input from file instead of the standard input. This option is supplied specifically to avoid the use of the standard input within the IRAF cl. Other users may use it if they like.
-k
Check the validity of the input table. Exit with status is 1 if the table is not ok.
-o file
Write output to file instead of the standard input.
-t template
Only the tables whose table names (first line in the table header) match template are output. Care should be taken with this option, unnamed tables are skipped. This is the primary mechanism for selecting a table from a multi-table file.
-u
Read the standard input in unbuffered mode. This is a very useful option for taking the header part off of a starbase table and passing the rest to another unix program filter. See the source of headtable as an example.
-v
Verbose error checking. Print messages about offending rows to the standard output. If check is being run the entire table is checked. If only -k is specified the program exits when it finds the first error.
-2
Print each row in the table twice. This option is useful with sortable to eliminate or select duplicate rows. This is the underlying mechanism of diffrtable and intertable.
column=newcol
rename a column. Columns may be renamed by any of the column programs. Before the rename option the column must be referenced by its old name, after by its new one. Renaming a column does not select it for output.

Justification Options

The use of any justification flags implies that all the columns will be justified. If a justification type is not given for a column with the a flag or sticky option that column will be default justified. The default justification is left for strings and right for numbers. Justification flags that are given as options are sticky and effect all the following columns until additional flags are given. Flags may also be suffixed to the column names to change the justification of a particular column. A justification flag on a column is indicated by a ":". The output width of a column may be appended to a column name with a ".".
-d
Justify the column with its default justification. Numeric values are right justified and text is left justified.
-l
Left justify.
-c
Center justify.
-r
Right justify.
-e
Expand the column.
-w width
Set the output column width. Care should be taken with the width option, data column will be truncated if they are width than the width specification.
-x
Delete the column.
-p
Pass the column through with no justification.

EXAMPLES

Example 1:

Ask for all the column from the standard input 


	$  column <  input 
	X	Y
	-	-
	0	1
	0	1
	0	1

SEE ALSO

column
project columns from a starbase data table.
project
project columns from a starbase data table.
justify
justify columns of a starbase data table.
trim
trim columns of an starbase data table.
check
check the format of a starbase data table.
header
print the header of a table file.
headoff
print the body (data rows) of a starbase data table file wo/ the header.
headline
print the column headline of a starbase data table.
dashline
print the dashline from a starbase data table.
starbase.1
starbase data tables introduction.
starbase.3
starbase data table C library.
starbase.5
starbase data table file format.

NOTES

This man page was written with p2man.