Name
std - standard star search
Synopsis
std [fetch] [search] [display]
Description
std is a command-line tool which allows to browse a
database of infra-red standard stars. std contains inter-
nally a database of more than 800 stars, built-up by
J.G.Cuby. Options are offered to get a database from a
local data file, or from a URL if a net link is available.
From the input catalog, it is possible to select stars
based on a position criterion, name, sky region, or magni-
tude in a given band. Results can be displayed in differ-
ent formats.
Fetch Options
The fetch options are related to the way the standard star
database is retrieved. By default, the internal database
will be used.
-f/--file filename
Declare the full path to a standard star database
in ASCII format. Not supported yet.
-g/--get url
Declare a URL from where the database file can
directly be downloaded. Will only support HTTP
protocol. Not supported yet.
Search Options
Search options are related to different user-defined cri-
teria to select a number of stars in the database. The
following are implemented:
-p/--pos HH MM SS DD MM SSorDD DD
If this is the only search criterion on the com-
mand-line, only the closest star to this position
will be returned. The position can be provided as
hours, minutes, seconds for RA and DEC (6 values
expected) or simply in degrees (2 values expected).
-r/--radius value
Together with the --pos option, this specifies a
radius around a sky position. All stars within this
region will be selected.
-n/--name value
To search stars by name. The provided value is a
regular expression, all stars matching it will be
selected.
-m/--mag band min max
To search stars by magnitude range in a given wave
band. Supported wave bands are: J, H, K, Ks, L, M.
Minimum and maximum magnitudes define a range into
which all stars are selected.
Display Options
-k/--key
To display the output in keyword format. See output
examples below.
-o/--one
To display the output in one-liner format. See out-
put examples below.
-s/--show fields...
To select fields to be printed out only. Field are
selected if their name appears in the list. Fields
are: name (star name), pos (position of the star,
RA and DEC in hours, minutes, seconds), type (spec-
tral type), temp (star temperature from its spec-
tral type), mJ (magnitude in J), mH (magnitude in
H), mK (magnitude in K), mKs (magnitude in Ks), mL
(magnitude in L), mM (magnitude in M).
Files
The star database contains the following informations
about stars (in this order):
Name of the star
RA and DEC in HH:MM:SS format
Spectral type
Magnitudes in J, H, K, Ks, L, M.
Examples
To print out the closest star from position '10 12' (in
degrees):
std --pos "10 12"
To print out all stars within 10 degrees of this position:
std --pos "10 12" --radius 10
To print out all stars which name matches "FS*"
std --name "FS*"
To look for all stars in band L having a magnitude between
5 and 6:
std --mag "L 5 6"
To show only the names and positions of stars having a
magnitude between 10 and 12 in band J:
std --mag "J 10 12" --show "name pos"
Bugs
Only the internal database can be used for the moment.
It is not yet possible to combine selection criteria.