Non-sidereal tracking file on Subaru OCS
To track a target of non-sidereal movement, i.e. Solar System objects, the telescope control system (TCS) needs right ascension (RA), declination (Dec), and geocentric distance to the target for the time period during which observation will take place. TCS accepts a file for each target for each run or each night.
Subaru Software Division has prepared simplified procedures to create non-sidereal tracking files. An observer can either
- Prepare files using JPL Horizons before coming to the observatory and supply them to the TCS at the telescope,
- Create files at the telescope using the graphical user interface at the telescope, or
- Create files at Hale Pohaku using the command line interface.
Using JPL Horizons
Coordinate files created by the JPL HORIZONS System can be converted at the telescope site to be supplied to the TCS. Please supply the following parameters to the HORIZONS System. Observers may want to specify Time Span for each night with 1 minute Step Size.
Ephemeris Type | OBSERVER |
---|---|
Observer Location | Geocentric [500] |
Table Settings | 1. Astrometric RA & DEC, 20. Observer range & range-rate |
Display/Output | plain text or download/save |
Please bring the created files to the observatory or send them to the support astronomer.
The files should be uploaded to the observation control system (OCS) by the support astronomer. The files can be loaded to the Gen2 Integrated GUI then to to the TCS by following the menu: File - Load source - eph then pushing the button Convert and Copy to TSC* on the page viewer that appears when the file is loaded.
At the telescope
At the telescope, observers may use the Gen2 Integrated GUI to query coordinates of the target to the JPL HORIZONS System. Supply the name of the planet, planetary moon, asteroid, or comet to the input box next to the SolarSystemObject button in the TELESCOPE tab in the launcher pane in the lower left corner of the GUI.
Once the Gen2 Integrated GUI receives the answer from the JPL HORIZONS System, two viewer pages appear in the pane in the lower right corner of the GUI. Please select the .tsc tab and push Copy to TSC button to transfer the file to the TCS.
At Hale Pohaku
In the Subaru Office at Hale Pohaku, an observer has access to the observatory network but not to the Gen2 Integrated GUI. An observer may use commands logging into one of the servers from OCS to create non-sidereal tracking files.
jplHorizons
jplHorizons command queries the JPL HORIZONS System for coordinates through the name of a target. Please SSH to the host sumda.sum.subaru.nao.ac.jp by using your o-account and run the command. In the example below, start and end dates are specified in UTC while increments are specified in minutes.
$ jplHorizons -t Ceres --start=2013-04-30 --end=2013-05-01 --incr=60 --out=Ceres.tsc
The command-line options for jplHorizons are as follows:
- Help:
- -h or --help (Prints command-line options)
- Target name:
- -t or --target=<name> (Target name in JPL Horizons database - planet, planetary moon, comet or asteroid)
If the specified target name matches more than one item in the database, you will receive a prompt asking you to select the specific target desired.
- Start/end/increment for output:
- --start=<date/time> (start time of output, defaults to current time, UTC)
- --end=<date/time> (end time of output, UTC)
- --incr=<value> (increment between output points in minutes, default is 30 minutes)
- --duration=<value> (duration of observation in hours - can be used instead of specifying end time - default is 1 hour)
All date/time entries are UTC and can be YYYY-MM-DD HH:MM:SS, YYYYMMDD-HH:MM:SS, YYYYMMDD.DDDDD, JD, or MJD
- Output options:
- -o or --out=<filename> (output filename with TSC-format coordinates - default is output to screen only)
- --jplOut=<filename> (JPL Horizons output filename - default is to not output JPL Horizons results)
- Optional JPL Horizons input file:
- -f <filename> (JPL Horizons output file - will be converted to TSC-format coordinates)
nstrack
For targets which is not on the JPL HORIZONS System database, nstrack command may be used to specify orbital elements. Please SSH to the host sumda.sum.subaru.nao.ac.jp by using your o-account and run the command.o
$ nstrack --asteroid --epoch=2455400.5 \ --orbinc=10.58682 --Om=80.3932 --om=72.58981 --a=2.7653485 --e=0.07913825 --M=113.4104434 \ --start "2012-09-01 04:00" --end "2012-09-01 06:00" --out=Ceres.tsc --comment "Ceres on 2012-09-01"
The command-line options for nstrack are as follows:
- Help:
- -h or --help (Prints command-line options)
- Start/end/increment for output:
- --start=<date/time> (start time of output, defaults to current time)
- --end=<date/time> (end time of output)
- --incr=<value> (increment between output points, default is 30 minutes)
- --duration=<value> (duration of observation - can be used instead of specifying end time - default is 1 hour)
- Output options:
- --out=<filename> (output filename - default is output to screen only)
- --comment=<string> (comment string to write to output file)
- Major body options:
- --sun
- --moon
- --planet --name=<name>
Note that the combination of --planet and --name can be used to specify either the name of a planet or the name of a planetary satellite, e.g., Deimos, Phobos, etc. See below for a complete list of recognized planetary satellites.
- Asteroid options:
- Asteroids can be specified by name or by number or by orbital elements.
- --asteroid --name=<name>
- --asteroid --number=<n>
- --asteroid --epoch=<date> --orbinc=<value> --Om=<value> --om=<value> --a=<value> --e=<value> --M=<value> --equinox=<date>
- Comet options:
- Comets can be specified by name or by orbital elements.
- --comet --name=<name>
- --comet --epoch=<date> --orbinc=<value> --Om=<value> --om=<value> --q=<value> --e=<value> --Tp=<value> --equinox=<date>
- Orbital elements:
- --epoch => Epoch date of the elements
- --orbinc => Inclination wrt ecliptic (deg)
- --Om => Longitude of ascending node wrt ecliptic (deg)
- --om => Argument of perihelion wrt ecliptic (deg)
- --a => Semimajor axis of the orbit (AU) (asteroids)
- --q => Perihelion distance (AU) (comets)
- --e => Eccentricity
- --M => Mean anomaly (deg) (asteroids)
- --Tp => Perihelion date (comets)
- --equinox => Equinox date of the coordinates (defaults to 2000/1/1)
You can also place all the target information into a text file and then use the --infile=<INFILE> option to tell nstrack to read the information from the specified file. The input file contains the same attribute/value pairs that you would specify on the command-line. An example input file might look like this:
asteroid name=Ceres start='2012-09-01 04:00' end='2012-09-01 06:00' out=Ceres.out comment="Ceres on 2012-09-01"
All date/time entries are UTC and can be YYYY-MM-DD HH:MM:SS, YYYYMMDD-HH:MM:SS, YYYYMMDD.DDDDD, JD, or MJD
Other methods
There are some more options an observer can follow to create non-sidereal tracking files and/or bulk-transfer them. Please refer to the Non-Sidereal Targets which unfortunately only accessible from the observatory's network at the Hilo facility, in the Hale PoHaku office, or the telescope control building.
You may also wan to to refer to the traditional procedure.
Footnote
- TCS and TSC
- It is confusing but TCS stands for the Telescope Control System while TSC, being one of the computers in TCS, stands for the Telescope Supervise Computer.