Index for Researchers
Observing
|
|
Preparing OPE files for IRCS
Index
- 1. What is an OPE file?
- 2. Preparing the OPE file for IRCS observations
- 3. Download hoe
- 4. Basic steps to prepare an OPE with hoe
- 4-1. Object list
- 4-2. Start hoe and load object list
- 4-3. AO-mode and Guide star selection
- 4-4. Set IRCS setup
- 4-5. Create Base OPE
- 4-6. Create Plan OPE
- 5. Basic functions of hoe
Observations of Subaru Telescope are conducted by executing script files called 'OPE file (Observation Procedure Execute file)'.
Observers are requested to prepare the OPE file describing the sequence of your observing tasks prior to your run.
An OPE file consists of information on your targets and individual operating commands such as target acquisition, exposing, focusing, calibration frame, etc.
Please prepare for your OPE files and send them to the Support Astronomer (SA) by e-mail.
On the observing night, SA and telescope operator will load your OPE file onto the observation control system and perform the observation by following your requests.
Each individual command will be executed by SA on a line-by-line basis.
SAs can choose any command line to execute in your OPE file and you may also edit and modify the OPE file at the summit.
Although command lines do not have to be sorted exactly in the order of your observation plan, it would be helpful for SA to understand your intent
correctly and to prevent misoperation if you write down command lines in sorted order with a reasonable comment.
2. Preparing the OPE file for IRCS observations
|
There are two options to create the OPE file for IRCS.
- Prepare OPE files manually
You can create your own script file by referring to the instruction page.
- Use Subaru HDS++ OPE file Editor ("hoe") [NEW!]
Subaru HDS++ OPE file Editor ("hoe") is an application software to prepare observations. This software was
first created for OPE files for HDS, but now it is available for IRCS too.
Its fundamental purpose is to make operation (OPE) files for your observations.
Furthermore, you can create and modify your observation plan with the GUI of hoe.
There are many advantages using hoe:
- Observation plan including the aquisition time can be easily created and modified anytime.
- Visibility plots and finding charts can be created.
- Guide stars for NGS and LGS observation can be searched automatically.
- SA can provide a configuration file of hoe with information of satellite closure before your observation.
You can modify your observation plan with taking into account the closure information.
Basically, we ask all the observers to create the OPE with hoe.
Using OPE files generated by hoe will prevent unnecessary errors and troubles during the observation.
SAs request to exchange the configuration files (*.hoe) with the observers while the observation preparation phase,
instead of sending the ope file.
Please read the following instructions to install and use hoe on your computer.
Access the hoe download page on HDS website
to download the hoe.
4. Basic steps to prepare an OPE with hoe
|
The method to create an OPE file with hoe is mainly divided into three steps;
- Prepare object lists
- Set basic observation parameters with hoe
- Create a time-sequential plan with "Obs Plan Editor" included in hoe
In the case that there are many targets to observe and you want to decide the
order during the observation, you can stop at step 2 and create a "Base OPE".
Base OPE is a simple OPE file describing a list of observation commands for each target and for each setup.
On the other hand, "Plan OPE" show commands which are lined up
following your observing plan.
Elapsed times for each command are calculated and target times are labeled with commands.
You can see the instruction movies from the following links (to YouTube).
- Step 1 and 2
- 0:03~ Prepare a Target list text (CSV) file
- 0:31~ Start up "hoe"
- 1:30~ AO-mode & Guide star selection
- 1:42~ Case A: NGS (= Target)
- 2:42~ Case B: NGS (= offset guide star)
- 3:31~ Case C: LGS (Tip-Tilt GS = Target)
- 4:16~ Case D: NGS (Tip-Tilt GS = offset star)
- 5:08~ Double star exclusion
- 7:01~ Automatic AO-mode & GS selection
- 8:21~ Set IRCS setups
- 9:07~ Create a Base OPE file
- 9:50~ Save to a Config file (.hoe)
|
|
See the following instructions for further information.
4-1. object list
To make an OPE file you have to prepare your target list at first.
Although you can create your object list within the hoe, the easiest way is to load the following types of files to hoe.
☐CSV (comma separated) list
You can use CSV list text files which contains information as below.
Object Name, RA(hhmmss.ss), Dec(ddmmss.ss), Equinox, Free comments
For example,
HD94028 ,105128.1 ,+201639.0 ,2000, [comments]
BD+36 2165 ,111248.0 ,+354343.9 ,2000, Mv=8.4 Fe/H=-2
BD-13 3442 ,114650.7 ,-140643.5 ,2000,
You can also load CSV files including magnitudes of each target in their 5th column.
HD94028 ,105128.1 ,+201639.0 ,2000, 8.2, [comments] 300x1
BD+36 2165 ,111248.0 ,+354343.9 ,2000, 9.8, 480x1
BD-13 3442 ,114650.7 ,-140643.5 ,2000, 10.3, 600x2
☐OPE file of previous observations
You can use OPE files for Subaru Gen2 system as your target list.
Each target must be defined with its OBJECT (name), RA, DEC, and EQUINOX within <PARAMETER_LIST> section of OPE files as follows.
<PARAMETER_LIST>
TGT_V5668Sgr=OBJECT="V5668 Sgr" RA=183656.87 DEC=-285539.30 EQUINOX=2000.00
TGT_HD164536=OBJECT="HD164536" RA=180238.62 DEC=-241519.39 EQUINOX=2000.00
TGT_sigSgr=OBJECT="sig Sgr" RA=185515.93 DEC=-261748.21 EQUINOX=2000.00
☐Non-sidereal tracking file (TSC format)
Non-sidereal tracking files for TSC are also loadable.
#1 Ceres on July 26 HST
+00.0000 +00.0000 ON% +0.000
UTC Geocentric Equatorial Mean Polar Geocentric
ABS
TSC
500
20010727000000.000 185406.057 -303521.41 1.953782861 2000.0000
20010727003000.000 185405.055 -303524.50 1.953904593 2000.0000
20010727010000.000 185404.053 -303527.59 1.954026432 2000.0000
Please put TSC files in an appropriate directory (maybe in the same directory where your OPE files locate).
Files must follow the format described in this page.
You should use Geocentric coordinate in TSC files.
They would be automatically converted into topocentric in the program.
Therefore, coordinates displayed in hoe would not be the exactly same as ones described in non-sidereal tracking files.
☐Non-sidereal tracking file (JPL HORIZONS format)
NASA JPL
HORIZONS output files can also be used as an input file.
Please note that you should set
"Ephemeris Type" = OBSERVER
"Observer Location" = Geocentric
"Table Settings" = 1. Astrometric RA & Dec, 20. Observer range
for your input. Either calendar date or JD is acceptable for date format.
4-2. Start hoe and load object list
- Start hoe. If there is a new version of hoe, please download it and use the most
current version. Select "IRCS" as an instrument.
- Set information in the "General" tab.
- Date is the date of the observation in HST (Hawaiian Standard Time at the evening of the observation night).
- ID and Pass are for the "o-account" of Gen2 system. If you don't have them, please skip them.
- Base OPE shows a total exposure time needed to observe all the listed targets with all the setups defined in hoe.
This time also includes times needed for readout, telescope slewing, target acquisitions, and AO setup).
- Plan OPE shows the observation time created by Obs. Plan Editor. Here, all telescope slewing times are calculated
considering their celestial positions (The Base OPE estimation just assumes that each target acquisition takes 300 sec for all targets).
For service programs, estimated obs. times must not exceed 4 hours.
-
Click File in the Menu bar and load your object list. The targets included in the uploaded object list will appear in the "Main Target" tab.
- The defalt PA is set to "+90 deg". With this angle, the obtained image in Imaging mode will be "North up". See below for details.
-
If you want to select standard stars and add them to your object list,
- Go to the menu bar and select Database→Param for Standard. There are several ways to
search the standard stars. When using the Standard Star Locator, select the catalog, magnitude range, and the
spectral type. If you want to search a Rapid Rotators for High Resolution Spectroscopy, set the v sin(i),
V mag, and the spectral type. The search area can be set at Sky Area.
- Go to the Main Target tab and select the type of the standard star search at Standard Stars
located at the bottom of the window. Then click the search botton. The results will appear in the Standard tab.
Select an appropriate star and click + Standard button to add the star to the Main Target tab.
4-3. AO-mode and Guide star selection
IRCS observations are always conducted with A0 188. Therefore, all of the targets need an appropriate guide star.
- Criteria for a guide star (see here for detailed information.)
- NGS
- R =16.5 mag or brighter
- within 30'' of the target
- Point source with no nearby star within 0.5 - 1.5 arcsec (star with separation of < 0.5 arcsec is fine)
- LGS
- R =18.0 mag or brighter
- within 60'' of the target
- Point source with no nearby star within 0.5 - 1.5 arcsec (star with separation of < 0.5 arcsec is fine)
To find and select a guide star with hoe, follow the steps below.
- Select the target that you want to set the guide star in the Main Target tab.
- Open the Finding Chart by clicking the button. Finding Chart window will pop up.
- Click the Settings button at the right side of the Finding Chart window (shown with the red box in the figure above). Select GSC or
Gaia at the Optical part of the Change Parameters for database query window and click
Set Param. Go back to the Finding Chart window and click the Search button (shown with the blue box in the figure above). The stars in the database
will be selected automatically.
- All the selected stars will be indicated with boxes in the Finding Chart window. The data of these stars are shown in the DB / Finding Chart tab.
Select an appropriate guide star and click the button. Then change the AO-mode to the
appropriate mode.
- If the target itself is a bright single star, it can be the NGS itself. Select NGS(self).
- If there is a bright target within 30'', that star can be an offset NGS. Select NGS(offset).
- If the target itself is bright enough to be a Tip-tilt guide star, select Select LGS(self-TT).
- If you select a nearby star as a Tip-tilt guide star, select Select LGS(TT-GS).
- If you have many targets, you can use automatic AO-mode & guide star selection. From the menu bar, select IRCS→
Guide-star & AO-mode→by GAIA(G) (or by GSC 2.3 (R)). Check the searching parameters before query.
The selected guide star for each object can be checked from the Finding Chart window.
If you want to change the guide star and the AO-mode, it can be re-selected manually after the auto-selection.
- In the case you are using lager guide star, you have to send the target list that you going to use laser.
Send the *.hoe file which includes all the target (with guide star selected) to the SA one week
before your observation.
4-4. Set IRCS setup
- Select the IRCS tab.
- Set the IRCS settings that you will use for the observation.
- Imaging
Select the image resolution, filters, and dithering pattern.
- See here for the information of available filters.
- See here for detailed information of dithering patterns.
- Grism spectroscopy
Select the image resolution, band, slit, and dithering pattern.
- See here for the information of grism sensitivities and resolutions.
- See here for the information of available slits.
- See here for detailed information of dithering patterns.
- Grism spectroscopy
Select the wavelength coverage, slit, and dithering pattern.
- See here for the information of wavelength coverage.
- If you want to set the custom echelle and cross-disperser angle, see here.
- See here for detailed information of dithering patterns.
- Set the typical exposure time at Def. Exp.[s]
- Click the + button to add the setting to the list. Put all of the settings that you will use during your observation.
4-5. Create Base OPE
Base OPE can be created after the AO-mode, guide star, and the IRCS setups are determined. Go to the menu bar and select File→
Write Base OPE to create it. This OPE file will contain all the commands needed to obtain all the data of your targets with each setup.
4-6. Create Plan OPE
You can create your observation plan with Obs Plan Editor. Go to the menu bar and select Edit→
Obs. Plan Editor.
- Set the start time
The observation start time can be modified at the bottom of the Obs. Plan Editor window. Set the start time or Delay from Sunset
and click the reload button.
- Set azimuth and elevation of the telescope
In general, the telescope is pointed to the azimuth and elevation of the first target before sunset, to maximize the observation time. To create an accurate observation
plan, you can put the initial telescope azimuth and elevation. The SetAzEl is listed in the plan by default. Double click this command to change the
amount of Az and El. You can also add this command from the SetAzEl tab.
- Add targets
- Click the position in the list that you want to add the target. The plan will be inserted into the line just above the one you selected.
- In the Object tab, select the target, exposure time, coadds, NDRs, and the number of dithering sets needed. If you are going to
obtain data with different settings on the same target, you can select GetObject only instead of SetupField -- GetObject.
- Select the IRCS setup which will be used. The dithering pattern, dithering width, etc. can be modified.
- Click the + Object button to add the target to the plan list. The overhead time will be automatically calculated based on the amount defined in the
Overheads tab in the hoe main window. You can modify these values based on your experiment.
- Calibration data
Plan to take calibration data (flat, comparison) are listed as default. Additional plan to obtain flat can be added by using the Flat tab.
- Modification of the plan
Existing plans can be modified by double-clicking the line.
- Visibility plot
The visibility plot of the target can be seen by clicking the .
- Plot: Single object will only plot the object selected in the Obs. Plan Editor window.
- Plot: All objects will plot all the objects in the "Main Target" tab of the main window.
- Plot: Observing Plan will show the plot when the observation is planned.
- Sky monitor
The position of your target in the sky during the night can be checked by using the skymon ().
- Mode: Set will show the positions of your targets at a certain time.
- Mode: Plan will show the positions of the targets when the observation is planned.
- Write Plan OPE
Go to the menu bar and select File→Write Plan Ope. The observation plan summary can be written out by selecting Write Plan Text.
File
|
Open List
|
Open CSV text list in the local system.
Maximum object number is 5000.
|
Merge List
|
Merge CSV text list in local system.
|
Merge List from OPE
|
Import target list from an OPE file.
|
Merge List from Config (.hoe)
|
Import target list from the *.hoe file.
|
Non-Sidereal
|
Merge TSC file
|
Merge a Non-Sidereal target described in telescope tracking file (TSC format).
|
Merge JPL HORIZONS file
|
Merge a Non-Sidereal target described in JPL HORIZONS format.
|
Convert HORIZONS to TSC
|
Convert and save JPL HORIZONS format into TSC tracking file.
|
Initialize Target List
|
Initialize the target list in Main Target TAB.
|
Write Base OPE
|
Create a Base OPE (Simple OPE files describing a list of observation commands for each target) file.
|
Upload OPE
|
Upload an OPE (or other) file to the summit Gen2 system (sumda:/home/oXXXXX/Procedure/).
This function is available only inside of Subaru Telescope Network.
|
Write PROMS Target List
|
Write a target list text file that can be used for the Subaru Telescope Proposal Management System (PROMS).
Magnitudes should be added to all of your targets before using this function.
|
Write Service Request
|
Write a setup request file that can be attach to your Subaru Service program proposal.
|
Load Config
|
Load all contents of hoe which saved in a *.hoe file.
|
Save Config
|
Save all contents into a *.hoe file.
|
Change Instrument
|
Change the instrument for your observation.
Be aware that the observation plan in hoe will be initialized with this instrument change.
|
Quit
|
Quit the hoe program.
Save Font and Browser setups in General TAB into HOME$/.hoe. It will be referred at the next starting up.
|
Edit
|
Obs. Plan Editor
|
Start Obs. Plan Editor to make an observation plan.
|
Text Editor (Saved OPE)
|
Start the text editor with a last saved OPE file.
(This function is deprecated.)
|
Text Editor (Select OPE)
|
Start the text editor with a chosen OPE file.
(This function is deprecated.)
|
Tool
|
PDF Finding Charts
|
Create a PDF file which includes a list of finding charts for all of your targets.
|
Sky Monitor
|
Start the Sky Monitor.
Its function is almost equivalent to that of hskymon.
|
Database
|
Data Archive List Query
|
SMOKA
|
Batched queries with SMOKA for the target list in Main Target TAB.
This is the same one involved in hskymon.
|
HST archive
|
Batched queries with HST archive for the target list in Main Target TAB.
|
ESO archive
|
Batched queries with ESO archive for the target list in Main Target TAB.
|
Gemini archive
|
Batched queries with Gemini telescope archive for the target list in Main Target TAB.
|
Catalog Matching
|
SIMBAD
|
Batched queries with SIMBAD. A brightest (or nearest if no one has magnitude info.) object
within a specified search radius would be selected as a counterpart.
Therefore you should narrow the search radius as long as the reliability of target coordinates permits.
Magnitude information will be added into the list in Main Target TAB.
The queried result will be displayed in DB / Main Target TAB.
|
NED
|
Batched queries with NED.
This query never adds magnitude information into the list.
|
LAMOST DR3
|
Batched queries with LAMOST.
This query never adds magnitude information into the list.
|
GSC 2.3
|
Batched queries with Guide Star Catalog.
Magnitude information will be added into the list in Main Target TAB.
|
PanSTARRS-1
|
Batched queries with PanSTARRS catalog.
Magnitude information will be added into the list in Main Target TAB.
Please be aware that the same object tends to be listed with two or more different coordinates in PanSTARRS catalog.
|
SDSS DR14
|
Batched queries with SDSS catalog.
Magnitude information will be added into the list in Main Target TAB.
|
GAIA DR2
|
Batched queries with GAIA catalog.
Magnitude information will be added into the list in Main Target TAB.
|
Kepler Input Catalog
|
Batched queries with Kepler Input Catalog.
Magnitude information will be added into the list in Main Target TAB.
|
2MASS
|
Batched queries with 2MASS catalog.
Magnitude information will be added into the list in Main Target TAB.
|
Param for Standard
|
Parameters for finding standard stars (for Standard Locator/Rapid Rotator/Mid-IR Standard in Object List Window).
|
Param for DB Query
|
Change search parameters for database query in Finding Chart Window.
|
IRCS
|
Set Default AO-mode/PA
|
Set the default AO-mode and PA used in the hoe.
|
LGS
|
These commands are used for LGS preparation. Although most of the functions are for SA, observer can create a list of LGS targets by using
Write LGS target list.
|
Guide star and AO-mode
|
This is used for automatic guide star and ao-mode selection. See 4-3-5 for further information.
|
Info
|
Check the latest ver.
|
Check the latest version of hskymon via network.
|
About
|
About this program.
|
- How to plan and make a request form of service observations
- Create the targets list and load it to hoe.
- Select guide stars required for the AO.
- Input the brightness information for all of your targets (you can input this information manually afterward).
- Make the observation plan with Observation Plan Editor.
Please make sure that your observation does not exceed 4 hours.
- Write the service observation request form from File→Write Service Request.
The created form does not include all the information required for the propsal.
Check all items before attaching it to your proposal.
Oct 19 2020
|