SCT: Importing Source Lists

Note: due to a recent upgrade in Firefox (version 115.x), the functionality of uploading Source lists as a text file has been broken. If you want to upload Source lists as a text file, NRAO staff have determined that the following browsers and platforms will work: Safari (Mac), Chrome (Mac, Windows, Linux), Opera (Mac, Windows, Linux), and Microsoft Edge (Windows).

Syntax

Text files with source lists can be imported into the SCT if they use the following syntax. Note that this is the same format as for the PST, so if you have uploaded your source list into the PST, you can use the same file for uploading in the SCT. Every line containing any source information in the file must define a separate source as:

sourceName;groupNames;coordSystem;epoch;longitude;latitude;refFrame;convention;velocity;calibrator;

The text file should only contain lines formatted as above, or lines that are known to be ignored by the parser (i.e., empty or whitespace-only lines and comment lines starting with an # (octothorpe)). An (optional) exception is if the very first line is starting with an * (asterisk); the string after the asterisk will replace the default source catalog name, where a leading space in the string is ignored. Start with the catalog name syntax line before any source syntax line or any comment line or this source catalog name will not be picked up (and an "[Unnamed Catalog]" results):

* Source catalog name in the SCT
# this is a line with a comment and the previous line is the syntax used to include all sources into a non-default
# (the catalog name line will be ignored by the PST when uploading this file)
# the rest of the source list file contains source lines mandated as above and other ignored lines
<source1 line>
<source2 line>
...

Every data line must have ten semi-colons (;), including the one after the final calibrator field; note that the catalog name line, the one starting with the asterisk, should not contain any semi-colon.

Details and possible (predefined) values per field are described in the table below.

sourceName	Mandatory, single value Unique name for the source, free-format text. Multiple lines with the same source name, longitude, latitude and velocity information (below) will end up as a single source entry.

groupNames	Optional, unlimited number of comma-separated values Group(s) or sub-catalog(s) to which this source belongs, free-format text. If no group name is given the source will be listed in the main (top-level) catalog only.

coordSystem	Optional, single value (defaults to equatorial), not case-sensitive Coordinate system in which longitude and latitude angles below are defined, typically Equatorial for source coordinates in RA and Dec. (the default). Valid options are: Ecliptic, Equatorial, Galactic. Sources converted to other, e.g., equatorial coordinates will show an asterisk with the converted coordinates in the catalog.

epoch	Optional, single value (defaults to J2000), not case-sensitive Epoch for which longitude and latitude angles below are defined, valid options are: B1950 and J2000.

longitude	Mandatory, single value An East-West angle, typically Right Ascension. Valid options are a numerical value in decimal degrees or a sexagesimal colon-delimited value in hh:mm:ss.sss. . . (with or without leading zeros) for hours : minute : seconds. Either form may be preceded by the plus (+) or minus (−) sign.

latitude	Mandatory, single value A North-South angle, typically Declination. Valid options are a numerical value in decimal degrees or a sexagesimal colon-delimited value in dd:mm:ss.ss. . . (with or without leading zeros) for degrees : arcminute : arc-seconds. Either form may be preceded by the plus (+) or minus (−) sign.

refFrame	Mandatory in combination with convention and velocity, single value, not case-sensitive The reference frame in which the velocity below should be interpreted. If any of refFrame, convention or velocity is specified, all three must be specified to make sense. Leave all three blank if no velocity information should be included in the source properties. Useful valid options with their abbreviations are: Barycentric (Bary), LSR Kinematic (LSR or LSRK), Topocentric (Topo).

convention	Mandatory in combination with refFrame and velocity, single value, not case-sensitive The frame definition in which the velocity below should be interpreted. Useful valid options are: Optical, Radio, Redshift.

velocity	Mandatory in combination with refFrame and convention, single value A decimal number, optionally preceded by the plus (+) or minus (−) sign, to express the source velocity in km/s, or to express the source redshift in z if the convention above is Redshift

calibrator	Optional single value (defaults to N), not case-sensitive A value of Y or N to indicate whether a source is to be used as calibrator. The SCT will ignore this field; it is retained to maintain compatability with the PST and other tools. Instead, calibrators for the VLA are identified with scan intents in the OPT.

To ingest a text file with a source list, navigate to the SCT. Select from the menu FILE → IMPORT and then select PST for the import format. After providing a file to import, a new catalog with the default name [Unnamed Catalog] will be created. If the imported sources need to be included in a different catalog, or a different catalog group, use the general copy/paste method of the web application to move the sources around. Alternatively, change the name of the new unnamed catalog in the SCT using the Properties tab of that catalog if a name was not specified with an * (asterisk) line.

Source List Examples (in SCT/PST format)

Minimalist: Source name and coordinates only, default coordinate system, epoch and unspecified velocity.

J0433+0521;;;;04:33:11.095535;05:21:15.619420;;;;;
J1119−0302;;;;11:19:25.3;−03:02:51.32;;;;;
<some_name> <4 times ";"> <RA_j2000> ; <Dec_j2000> <5 times ";">

Explicit: Same data as minimalist, above, but with coordinate system and epoch stated in long form, and spaces for ease of reading.

J0433+0521; ; equatorial; J2000; 04:33:11.095535;  05:21:15.619420; ; ; ; ;
J1119−0302; ; equatorial; J2000; 11:19:25.3     ; −03:02:51.32    ; ; ; ; ;

Full: All fields are specified, starting by naming the catalog MyPrivateList in which these sources should appear (instead of the default Unnamed Catalog); multiple values in those fields that allow it, with spaces in source and group name, some case-preserved and case-ignored variable names, and with optional trailing comma in velocities.

* MyPrivateList
# This is my private list of secret sources..
Secret Source; My Recipes, Private; equatorial; J2000; 12:34:56.789; 87.65432; lsR; Optical; −98.6,; y;