Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

skycatalog.fromascii - Function

	Package	display
	Module	viewer
	Tool	skycatalog

Create the tool from an ascii file

Synopsis
fromascii(asciifile, hasheader, longcol, latcol, dirtype, unit)

Arguments

asciifile		The source ASCII file
		Allowed:	String
		Default:	unset
hasheader		Does the ASCII file include a header definition?
		Allowed:	Boolean
		Default:	F
longcol		The column name or number containing the Longitude component
		Allowed:	String or Integer (see description)
		Default:	unset
latcol		The column name or number containing the Latitude component
		Allowed:	String or Integer (see description)
		Default:	unset
dirtype		The direction type of the coordinate
		Allowed:	String
		Default:	J2000
unit		The unit of the coordinates
		Allowed:	String
		Default:	deg

Returns
T or F

Description

This functions converts an ASCII table into an AIPS++ skycatalog table. These tables can be read by the Viewer tool and displayed as a skycatalog overlay. Whitespace in the ASCII tables is interpreted as a column separator and the number of columns per row must be constant. The ASCII table can start with a description of the columns and the data types in that column. If this header is not specified the tool tries to determine the data type and will name the columns Column1..ColumnN. In that case the columns containing the coordinate can be given as integer indices.

The argument dirtype indicates what direction coordinate reference type your coordinate has. At the moment only J2000, B1950, GALACTIC and SUPERGAL are valid types.

The unit is assumed to be the same for long and lat and only has to be specified if the coordinate is given decimals.