Getting Started Documentation Glish Learn More Programming Contact Us
Version 1.9 Build 1556
News FAQ
Search Home


next up previous contents index
Next: componentlist.concatenate - Function Up: componentlist - Tool Previous: componentlist - Constructor


asciitocomponentlist - Constructor



Package synthesis
Module componentmodels
Tool componentlist


Create a componentlist from an ascii file


Synopsis
asciitocomponentlist(filename, asciifile, refer, format, direction, spectrum, flux, log)



Description

This constructor allows conversion of a number of ascii-file-based formats to componentlists. The formats currently supported are the AIPS star file format, the Caltech model format, and the WENSS, FIRST, and NVSS surveys.

AIPS ST file
The AIPS star file describes positions of ``stars'' that one might wish to plot overlaid on some other display. It does not contain source strength information. In the AIPS help file for STARS, the format of the star file is described as follows:
    The text file contains one line per star and each line has
up to 7 logical columns containing, in order:
   1. X position (Right Ascension 00 00 00.00)
   2. Y position (Declination +/-00 00 00.0)
   3. Major axis (Full width in arc seconds on sky)
   4. Minor axis (Full width in arc seconds on sky)
   5. Position Angle (E of N, degrees)
   6. Star Type  (-1 to 20, integer )
   7. Star label (up to 24 character string)
If X and Y are not RA-DEC or DEC-RA, then the logical columns
are also 7 actual columns and the units are in AIPS standard
units (e.g. degrees, m/s etc. ).  In this case the position
angle should be given as 0.0, the major axis is the width in the
Y coordinate and the minor axis is the width in the X
coordinate.  For RA and DEC positions, the sexagesimal notation
is used (e.g. HH MM SS.SSS -DD MM SS.S) for the positions and
arc seconds on the sky are used for the Deltas.
The last 5 columns are not required.  If the last 5 columns are
not given, a value of 1 cell is assumed for the deltas.
If the position angle is not included, the default is 0 degrees.
If the star type is not included, the default type is a cross.
The default is no label string.
There are currently 22 different types of star marks.
 < 0: No Mark, only the star label is printed
   0: Cross             10: Five pointed star
   1: Ellipse           11: Star of David
   2: Box               12: Seven pointed star
   3: Triangle          13: Eight pointed star
   4: Diamond           14: Nine  pointed star
   5: Pentagon          15: Ten   pointed star
   6: Hexagon           16: 11    pointed star
   7: Septagon          17: 12    pointed star
   8: Octagon           18: 13    pointed star
   9: Nine-gon          19: 14    pointed star
  20: Cross with gap   >20: Ellipse
The Box (type=2) is different from the diamond in that the
star size is the half height and width of the box dimensions.
The Box and the Null (<0) are labeled at RA and Dec plus Delta
RA and Delta Dec.  The other marks are labeled at the right
edge of the of the Rotated RA axis.  The CROSS WITH GAP
(type=20) has the inner third of the cross removed so the
marked object is not over written.

For more information, see the AIPS help file for STARS.

Caveats:

  • In AIPS, the following are supported: 1: 1900; 2: B1950; 3: J2000; 4: Galactic 5: OHLSSON Gal.; 6: VAN TULDER Galactic; 7: Super Galactic; if > 1000 then year assumed. Currently, AIPS++ can support 2 (refer='b1950'), 3 (refer='j2000'), 4 (refer='gal'), 7 (refer='supergal'). If you need any of the others, please contact us.

Caltech
The jp/citvlb/index.html">Caltech package uses a format for specifying positions relative to an undefined position. In the documentation for modelfit, the format is described as follows:

     Model files are text files that can be typed or printed directly;
they  can  be  modified or created using the standard text editors.  A
model file consists of one line for each component of the model,  with
up to 7 numbers on each line (in free format):

     1.  Component flux density (Jy)

     2.  Distance of center of component  from  origin  (milliarcsec),
         "radius"

     3.  Position angle of center of component  with  respect  to  the
         origin (degrees, North through East), "theta"

     4.  Major axis of component (milliarcsec), "axis"

     5.  Axial ratio (minor/major, i.e.  < 1), "ratio"

     6.  Position angle of major axis (degrees, North  through  East),
         "phi"

     7.  Type:
             0 or 1:  elliptical Gaussian  (major  axis  is  FWHM)  or
             delta-function (major axis = 0)
             2:  uniform elliptical disk (major axis is diameter)
             3:  optically thin spheroid or tapered disk  (major  axis
             is diameter)
             4:  elliptical ring (major axis is diameter)
             5:  line (major axis is length)

For Gaussians and  delta-functions,  the  Type  can  be  omitted;  for
delta-functions, the major-axis, axial-ratio, position- angle and type
can be omitted.  (Not all the  programs  understand  types  2-5.)  The
"origin" is an arbitrary phase-reference point.  The maximum number of
components varies from 600  to  10000,  depending  on  the  individual
program.

Caveats:

  • In AIPS++, directions in componentlist are currently absolute only. Hence one must specify the reference direction.

WENSS
The Westerbork Northern Sky Survey (WENSS) is a low-frequency radio survey that covers the whole sky north of delta=30 degree at a wavelength of 92cm to a limiting flux density of approximately 18 mJy (5 sigma). This survey has a resolution of 54'' x 54'' cosec (delta) and a positional accuracy for strong sources of 1.5''. The WSRT Northern Sky Survey catalog is available via a Web interface. Use this interface to search for sources, choose the plain text output, capture the output into a file and then convert.

FIRST
Faint Images of the Radio Sky at Twenty-cm - is a project designed to produce the radio equivalent of the Palomar Observatory Sky Survey over 10,000 square degrees of the North and South Galactic Caps. Using the NRAO Very Large Array (VLA) and an automated mapping pipeline, they produce images with 1.8" pixels, a typical rms of 0.15 mJy, and a resolution of 5". At the 1 mJy source detection threshold, there are  90 sources per square degree,  35% of which have resolved structure on scales from 2-30". Go to the FIRST catalog search page, search for the sources that you want, cut out only the lines that include the sources, put in a file and then convert.

NVSS
The NRAO VLA Sky Survey The NRAO VLA Sky Survey (NVSS) is a radio continuum survey covering the sky north of -40 deg declination. A detailed description appears in the 1998 May issue of The Astronomical Journal (Condon, J. J., Cotton, W. D., Greisen, E. W., Yin, Q. F., Perley, R. A., Taylor, G. B., & Broderick, J. J. 1998, AJ, 115, 1693). Go to the NVSS catalog search page, search for the sources that you want, cut out only the lines that include the sources (you can leave in the alternating lines with error information), put in a file and then convert.

Caveats:

  • The catalog contains upper limits on some scale sizes. We have chosen to represent these as actual sizes.



Arguments

filename Name of output component list table
Allowed: String
Default: None
asciifile Name of input ascii file
Allowed: String
Default: None
refer Input reference frame
Allowed: Any valid direction reference frame
Default: J2000
format Name of format (only ST supported)
Allowed: String
Default: ST
direction Direction measure (for relative coordinates)
Allowed: Direction measure
Default: None
spectrum Default spectrum field
Allowed: Any valid spectrum field
Default: [type="Constant", frequency=[type="frequency" , refer="LSR" , m0=[unit="GHz" , value=1.0]]
flux Default flux field
Allowed: Any valid flux field
Default: [value=[0.0, 0.0, 0.0, 0.0], unit='Jy', polarization="Stokes"]
log Send a message to the logger
Allowed: Boolean
Default: T


Returns
Number of components found



Example
mycl := asciitocomponentlist('sgra-stars.cl', 'sgra-stars.stfile', refer='j2000', 
format='ST')

This takes an AIPS stars file in J2000 positions, and converts the positions into Galactic. The output is a component list on disk and available in Glish as mycl.





next up previous contents index
Next: componentlist.concatenate - Function Up: componentlist - Tool Previous: componentlist - Constructor   Contents   Index
Please send questions or comments about AIPS++ to aips2-request@nrao.edu.
Copyright © 1995-2000 Associated Universities Inc., Washington, D.C.

Return to AIPS++ Home Page
2006-10-15