STARS & MASTARS
On-Line Manual
Japanese
1 minute STARS Tutorial
What is STARS?
Requirements for Users
STARS Home Page
STARS Login Page
 STARS Search Criteria Pages Transfer Confirmation Page
Transfer Acceptance Page
Transfer Check Page
Calibration Data
1 Minute STARS - Tutorial

Probably, you have already been assigned a STARS User account and password and your Proposal IDs have been assigned to your User account. Observers receive a letter on arrival in Hilo that detail the STARS User and Proposal ID accounts for the observation. STARS User and Proposal ID information is sent through email for non-attending observers. User accounts are in the format: bsmith. Proposal IDs are in the format: o07428. In STARS Query, Proposal IDs also have instrument abbreviations as a suffix - for example, o07428_MCS (MOIRCS).

To Receive Data:
  • access 'https://stars.naoj.org'
  • select 'Search Observation Frames'
  • select 'Simple Query'
  • validate login and password (STARS User account format is 'bsmith')
  • choose Proposal ID from drop-down list, select 'Search'
  • display 'Your Query Results', select 'Offline', select 'Primary-UH' (if you are outside Subaru) or 'Inside-NAOJ-https' (if you are inside Subaru), push 'Transfer'. (STARS 1 returns a maximum of 3000 frames in one query with no warning - please break your query in two if you exceed this limit.)
  • display 'Transfer Request Confirmation', highlight and copy result-URL into buffer
  • paste result-URL into browser, access result-URL
  • validate login and password, login format is 'bsmith'
  • FITS frames are accessible (including md5's), use a download manager like DownThemAll for Firefox to retrieve files from directory listing.
  • Your data result will contain a file listing: '0_list_{datetime}'. If you download this one file, you can then non-interactively download the entire file list with one command from UNIX: 'wget --http-user={login} -http-password={password} -i 0_list_{datetime} -o {output.log}'. Note: Do NOT enter brackets {} when entering login/password/datetime/output log.
What is STARS & MASTARS?

STARS is the name of the Subaru Telescope data archive system in Hilo, Hawaii. STARS stores and manages all data taken at the Subaru Telescope and is operated by the National Astronomical Observatory of Japan (NAOJ) - located in Mitaka, Japan. In addition, the NAOJ maintains MASTARS, which is a mirror archive of Subaru Telescope observation data in Mitaka, Japan. Subaru data is sent to MASTARS every ten minutes throughout the night. Astronomers outside Japan may use STARS to access Subaru data. Astronomers inside Japan may use MASTARS to access Subaru data.

The mirrored archives in Hilo and Mitaka offer 24-hour online access to all Subaru observation data. Observers use their STARS User account to query frames and receive frames through the internet after observation. The STARS User account is only useful for accessing data through STARS & MASTARS Archive after observation. At the summit, attending observers access their data using SOSS Proposal ID only (ie, o08121). After the 18-month proprietary period, the data is available from the SMOKA Archive in Mitaka in perpetuity. Observers may also request tapes to be mailed to them from the STARS Archive.

Typically, attending observers receive their data during observation, without using a STARS User account. The STARS and MASTARS Archives are typically used by non-attending observers who do NOT receive their data from attending observers.

STARS:https://stars.naoj.org
MASTARS:http://www.mastars.nao.ac.jp/mastars/
SMOKA:http://smoka.nao.ac.jp/

If you have any problems or questions, please contact starshelp@naoj.org

Requirements for using STARS

PI's: Your STARS User account has been made, and you can access STARS Query at any time.

Attending Co-I's: You DO NOT Need a STARS user account to receive data at the summit or request tape from STARS!

All STARS users must be registered to STARS Archive. The registration process includes assignment to the correct Proposal IDs. All Principal Investigators are automatically assigned user accounts and assigned to their Proposal ID. Co-Investigators listed in PIs observation application do not need additional PI approval, Co-Investigators NOT listed in PIs observation application need PI approval to be assigned to the Proposal ID. Users are only able to search for data belonging to their registered Proposal IDs. User accounts are in the format: bsmith. Proposal IDs are in the format: o07428. In STARS Query, Proposal IDs also have instrument abbreviations as a suffix - for example, o07428_MCS (MOIRCS).

STARS 1 returns a maximum of 3000 frames in one query with no warning - please break your query in two if you exceed this limit.

STARS Home Page - https://stars.naoj.org

Users select the option to accomplish the described function.
  • Search Observation Frames - Observation frame search and retrieval
  • Search the Telescope Status Logs - TSC Status Log search and retrieval
  • Search Telescope Conditions - Graphical Display or Download of Telescope Conditions
  • How to Search STARS/MASTARS - On-Line Manual (this page)
  • Registration Statistics - Statistics of Archive System
  • STARS Maintenance Schedule - System Schedule Announcements
STARS Login Page

There are several methods of searching the STARS Archive.
  • Simple Query - by Proposal ID, FrameID Range, Date Range, VGW, & Calibration Frames by Date
  • Detailed Query - all Simple Query choices + many more options
  • Query SkyMonitor Frames - Search for SkyMonitor data
  • Recheck Data Transfer Status - Check status of last transfer
There are 2 modes to search observation frames.

Simple Query
This is the simplest mode for data retrieval. It provides search capability by 'Proposal ID', 'Observation Date', and 'Frame ID', and includes options for including VGW Data and selecting Calibration Data from a date range. It is useful for retrieving data taken for a specific Proposal ID or date.

Detailed Query
This mode enable users to search the data based on all FITS keyword values in the data. Since more search criteria is possible, it is useful for retrieving data of certain data types (such as 'DARK') and searching for header values in certain ranges. This mode also provides a 'Name Resolver' for searches based on object names, and current NED's and MOKA's functions are supplied.

There are 2 utilities: SkyMonitor frames and Monitor Data Transfer.

SkyMonitor Mode
This mode enable users to retrieve data from the 'Subaru Infrared All-Sky Monitor.' All users with STN account can retrieve data in FITS format by specifying the date of collection. It is useful for monitoring sky changes during the observation.

Re-check Data Transfer Status
This mode enable users to re-login to the Transfer Check Page. It is useful for checking the status of data transfers.

Search Criteria Page - Simple Query

Users may set search criteria for data transfer. There are five criteria which may be defined.
  • Proposal ID - Select from the list. This is a required field.
  • Frame ID Range - i.e., From: 'OHSA00000001' to 'OHSA00001111'. If no Frame ID range is specified, all data belonging to the Proposal ID will be retrieved.
  • Acquisition Date - If no dates are specified specified, all data belong to the Proposal ID on any date will be searched)
  • VGW Data - Choose 'VGW Data' to include Autoguider images from this observation
  • Calibration Data - Calibration data should be included in your Proposal's frames. If calibration data is not included with your Proposal ID, you can access calibration data from the same date or different dates by filling in the date range for search.
Check boxes allow the user to:
  • Display the search results or not
  • Send the search results by e-mail or not
  • Include VGW data (such as AG and SV) or not
After selecting the 'Search' button, the data search will commence and the Transfer Confirmation Page. will display the search results.

Search Criteria Page - Detailed Query

Users may set detailed search criteria for data transfer. Many criteria may be defined. All defined FITS Keywords may be used for searches.

1. Proposal ID - Select from the list. This is a required field.

2. Frame ID Range - i.e., From: 'OHSA00000001' to 'OHSA00001111'. if no Frame ID range is specified, all data belonging to the Proposal ID will be retrieved.

3. Acquisition Date Range - If no dates are specified specified, all data belong to the Proposal ID on any date will be retrieved.

4. VGW Data - Choose 'VGW Data' to include Autoguider images from this proposal.

5. Calibration Data - Calibration data should be included in your Proposal's frames. If calibration data is not included with your Proposal ID, you can access calibration data from the same date or different dates by filling in the date range for query.

6. Calibration Template You may 'Use Calibration Template' to see your query reflected in the form, and update the template with your new choices using 'Reflect Template'.

7. Data Type Selection - You may select Raw Data and/or Reduced Data by QDAS.

8. Frame Type Selection - You may select checkboxes for values of Frame Type: Object, Flat, Comparison, Bias, Dark, Standard Star

9. Object-Frame Search Strategy - Input RA and DEC, Search Radius and Equinox.

10. Search Constraints

From 15 possible constraint statements, you may select a Category from the following values, which will automatically fill in the associated Keyword drop down list, for selection of constraints compared to 2 values (Value A & Value B):

Category Keywords
fits NAXIS, NAXIS1, NAXIS2, NAXIS3, NAXIS4
file BITPIX, CDELT1, CDELT2, CRPIX1, CRPIX2, CRVAL1, CRVAL2, CTYPE1, CTYPE2, CUNIT1, CUNIT2
origin FOC_LEN, FOC_POS, FOC_VAL, F_RATIO, OBSERVER, PROP_ID, PROPOSALID
object DATASET, DATA_TYP, DEC, DEC2000, EQUINOX, OBJECT, RA, RA2000
time FOC_LEN, FOC_POS, FOC_VAL, F_RATIO, OBSERVER, PROP_ID, PROPOSALID
telescope ADC, ADC_END, ADC_STR, ADC_TYPE, AG_PRB, AG_PRB2, ALTITUDE, ALT_END, ALT_STR, AZIMUTH, AZ_END, AZ_STR, IMGROT, IMR_TYPE, IMR_END, IMR_STR, INR_END, INR_STR, INSROT, M2_ANG1, M2_ANG2, M2_POS1, M2_POS2, M2_POS3, M2_TIP, M2_TYPE, SV_PRB, OBS_ALOC, TELFOCUS
environment CAS_TAVE, CAS_TMAX, CAS_TMIN, DOM_HUM, DOM_PRS, DOM_WND, NAS_TAVE, OUT_HUM, OUT_PRS, OUT_TMP, OUT_WND, SEEING, WEATHER
instrument AUTOGUID, BIN_FCT1, BIN_FCT2, COADD, COADDS, DAQ_VER, DETECTOR, DETPXSZ1, DETPXSZ2, DET_A00, DET_A01, DET_A02, DET_ID, DET_NSMP, DET_P101, DET_P201, DET_RST, DET_SMPL, DET_TAVE, DET_TMAX, DET_TMED, DET_TMIN, DET_TMP, DET_TSD, DET_VER, EFP_MIN1, EFP_MIN2, EFP_RNG1, EFP_RNG2, EXP_ID, FILTER01, FILTER02, FILTER03, FILTER04, FLT_A01, FLT_A02, FLT_A03, FRAMEID, GAIN, INSTRUMEN, INS_VER, NDR, OBS_MOD, PRD_MIN1, PRD_MIN2, PRD_RNG1, PRD_RNG2
wcs C2ELT1, C2ELT2, C2NIT1, C2NIT2, C2PIX1, C2PIX2, C2VAL1, C2VAL2, C2YPE1, C2YPE2, C3ELT1, C3ELT2, C3NIT1, C3NIT2, C3PIX1, C3PIX2, C3VAL1, C3VAL2, C3YPE1, C3YPE2, C4ELT1, C4ELT2, C4NIT1, C4NIT2, C4PIX1, C4PIX2, C4VAL1, C4VAL2, C4YPE1, C4YPE2, CD1_1, CD1_2, CD2_1, CD2_2, LONGPOLE, N2XIS1, N2XIS2, P2001001, P2001002, P2002001, P2002002, P2OJP1, P2OJP2, PC001001, PC001002, PC002001, PC002002, PROJP1, PROJP2, WCS_ORIG
polarimetry POLARIZR, RETPLAT1, RETPLAT2, RETPLATE, RET_ANG, RET_ANG1, RET_ANG2
spectroscopy APERTURE, DISPAXIS, DISPERSR, SLIT, SLTCPIX1, SLTCPIX2, SLTC_DEC, SLTC_RA, SLTC_LEN, SLT_OBJP, SLT_PA, SLT_PEND, SLT_PSTR, SLT_WID, WAVELEN, WAVE_MAX, WAV_MIN
focas F_CADREF, F_CAD_ID, F_DEWERX, F_DEWERY, F_DEWERZ, F_DISPER, F_HOLANG, F_MSK_ID, F_POSANG, F_SLT_NO, F_TMP_A, F_TMP_B, F_TMP_C1, F_TMP_C2, F_TMP_C3, F_TMP_D, F_TMP_E1, F_TMP_E2, F_TMP_F1, F_TMP_F2, F_TMP_G1, F_TMP_G2, F_TMP_H1, F_TMP_H2, F_TMP_I1, F_TMP_I2, F_TMP_J1, F_TMP_J2
hds H_AG_DEC, H_AG_EQN, F_AG_OBJ, H_AG_ODE, H_AG_ORA, H_AG_RA, H_CBLAZE, H_CCONST, H_CEPSRN, H_CGAMMA, H_CLFOCL, H_CLPSTN, H_CMRFL, H_COLLIM, H_CROSSD, H_CROTAN, H_DETROT, H_D_OTHR, H_D_UNIT, H_EBLAZE, H_ECONST, H_EEPSRN, H_EGAMMA, H_EROTAN, H_FOCUS, H_HARTMN, H_PITCH, H_SHUTTR, H_S_INCL, H_YAWING
ircs I_ARCH, I_BGRDL, I_BGRFL, I_BGRPW, I_BGRRT, I_CKMODE, I_CW1HV, I_CW1MP, I_CW2HV, I_CW2MP, I_CW2PK, I_CW3HV, I_CW3MP, I_CW3PK, I_DTHNUM, I_DTHPAT, I_DTHPOS, I_DTHSZ, I_FNAME, I_GRNS, I_HDRVER, IMCW1NM, I_MCW1PK, I_MCW2NM, I_MCW3NM, I_MDFMST, I_MECHAS, I_MECHHV, I_MECHMP, I_MFM1HV, I_MFM1MP, I_MFM1ST, I_MFM2HV, I_MFM2MP, I_MFM2ST, I_MFOCHV, I_MFOCMC, I_MFOCMP, I_MXDSAS, I_MXDSHV, I_MXDSMP, I_NDDCSZ, I_NDR, I_NDRASZ, I_NSQ, I_NSQMAX, I_NSUBAR, I_PGAIN, I_ROTAO, I_ROTNAO, I_SAR1CX, I_SAR1CY, I_SAR1HT, I_SAR1WD, I_SAR2CX, I_SAR2CY, I_SAR2HT, I_SAR2WD, I_SAR3CX, I_SAR3CY, I_SAR3HT, I_SAR3WD, I_SLWCNT, I_SLWHV, I_SLWMP, I_SLWNM, I_SLWPK, I_SPWHV, I_SPWMP, I_SPWNM, I_SLWPK, I_VBIAS, I_VDDUC, I_VDET, I_VGGCL
ciao C_AO, C_AO_FRE, C_AO_TIP, C_AO_WFS, C_BNCTMP, C_CAMERA, C_COLX, C_COLY, C_DETPOS, C_LYOANG, C_LYOTST, C_OMASK, C_SHUTTR, C_VACUUM, C_WATER1, C_WATER2
suprimecam S_AG_DEC, S_AG_EQN, S_AG_OBJ, S_AG_R, S_AG_RA, S_AG_TH, S_AG_X, S_AG_Y, S_BCTAVE, S_BCTSD, S_ETMAX, S_ETMED, S_ETMIN, S_FRMPOS, S_PFU_P1, S_PFU_P2, S_PFU_P3, S_UFNAME
ohs O_FOCVAL, O_MSK, O_SLT, O_SLTLEN, O_SLTWID
comics Q_ABTMP3, Q_ABTTP1, Q_ABTTP2, Q_CFTP1, Q_CFTP2, Q_CHOP, Q_CLKCLC, Q_CLKFL, Q_CLKMCC, Q_CLKNM, Q_CLKVER, Q_COHTP1, Q_COHTP2, Q_CPBMST, Q_CPEXAD, Q_CPFRAM, Q_CPFREQ, Q_CPNUM, Q_CPPA, Q_CPTHRW, Q_CPTIME, Q_CPWTP, Q_DETTP1, Q_DETTP2, Q_DETTP3, Q_DETTP4, Q_DETTP5, Q_DETTPI, Q_DTYPE, Q_FRRATE, Q_GRTANG, Q_GRTMOT, Q_INT1BM, Q_M1MOTA, Q_M1MOTB, Q_NDBEM, Q_NDCOM, Q_NDEFF, Q_NDOFDE, Q_NDOFRA, Q_NDRATE, Q_NDTIME, Q_OBSID, Q_OPTTP1, Q_OPTTP2, Q_OPTTP3, Q_OPTTP4, Q_OPTTP5, Q_OPTTP6, Q_PIXTIM, Q_READTM, Q_SHDTP1, Q_SHDTP2, Q_SLTVEW, Q_SPFILE, Q_SVFILE, Q_SVMAX, Q_SVWMAX, Q_SVWMIN, Q_SWINDOW, Q_WVMAX1, Q_WVMAX2, Q_WVMAX3, Q_WVMAX4, Q_WVMAX5, Q_WVMIN1, Q_WVMIN2, Q_WVMIN3, Q_WVMIN4, Q_WVMIN5
mirtos M_ARRANG, M_A_TMP1, M_A_TMP2, M_A_TMP3, M_A_TMP4, M_BANK, M_BBPOS, M_BBTMP, M_BEAM, M_BEAM1, M_BEAM2, M_BEAM3, M_BEAM4, M_CHID, M_CHOPPA, M_CHOPTH, M_CHOPTM, M_CLKFL, M_CLKMC, M_CLKMR, M_DARKID, M_DET01, M_DET02, M_FLATID, M_FRTIME, M_JPORT, M_M1MOT1, M_M1MOT2, M_M2MOT1, M_M2MOT2, M_NODPA, M_NODTH, M_NODTM, M_OBSID, M_O_TMP, M_PIXTIM, M_REFSUB, M_RFX1MM, M_RFX1MP, M_RFX1PM, M_RFX1PP, M_RFX2MM, M_RFX2MP, M_RFX2PM, M_RFX2PP, M_RFY1MM, M_RFY1MP, M_RFY1PM, M_RFY1PP, M_RFY2MM, M_RFY2MP, M_RFY2PM, M_RFY2PP, M_TWID, M_WINDOW
vtos V_CAMNUM, V_CAMPOS, V_CAMTYP, V_C_FRF1, V_DNAME, V_FR_P_N, V_FR_P_T, V_LENSFL, V_OBSMOD, V_XSTPOS, V_ZSTPOS
moircs undefined

The possible constraints for comparison to keyword values are:
  • From 'A' to 'B' - full range between 'A' and 'B'
  • >= 'A' - greater than or equal to 'A'
  • <= 'B' - less than or equal to 'B'
  • = 'A' - equal to 'A'
  • like 'A' - like 'A'
11. Output options - You may restrict the maximum number of matches through 'Search ... matches maximum'

In addition, checkboxes allow the user to:
  • Display the query results before transfer
  • Display the query results after transfer
  • Send the query results by e-mail
12. Output Columns - You may select Output Columns for the query results. There are checkboxes for:
FITS header file, Frame ID, DEC, ASCII Table extension, Data type, Date Obs, Quick Look Image, Object, HST, Memo, RA, ExpTime.
In addition, you may select from 15 options of Categories and Keywords, from the above table, to customize the output further.

After selecting the 'Search' button, the data search will commence and the Transfer Confirmation Page. will display the search results.

Transfer Confirmation Page

The Transfer Confirmation Page displays the search results. The following information will be listed:
  • Minimum Frame ID
  • Maximum Frame ID
  • Frame number
  • Combined size of all files (in MegaBytes)
Download Method: Select 'Offline' to access individual FITS frames directly. Select 'Online' to create a single tar/gz file, if number of frames is small.

Download Routing: This determines the access URLs for retrieving frames. Select
  • 'Primary-UH' - if you are outside Subaru Network
  • 'Backup-T1' - outside Subaru - if primary network is having trouble
  • 'Inside-NAOJ-http' - if you are inside Subaru and do not require encryption
  • 'Inside-NAOJ-https' - if you are inside Subaru and require encryption
Push 'Transfer' to copy frames from the Archive and make them accessible by URL.

STARS 1 returns a maximum of 3000 frames in one query with no warning of excess frames. Please break your query in two if you exceed this limit.

Transfer Acceptance Page

The Transfer Acceptance Page displays a message of acceptance of data transfer request. By selecting the 'Check' button, Transfer Check Page will be displayed.

The resulting listing from 'Data Transfer Mode - Simple Query Mode' includes the following items.
  • Links to HDI (FITS Header Information File)
  • Links to ATE (FITS ASCII Table Extension File)(only for HDS and MIRTOS)
  • Links to QLI (Quick Look Image File) (Only for SuprimeCam)
  • FRAME ID
  • DATA TYPE(OBJECT, DARK, FLAT etc)
  • Object's Name
  • Right Ascension
  • Declination
  • Observation Date
  • Start Time of Exposures
  • Exposure Time(in seconds)

If the user selects 'Send the Result by e-mail', an e-mail is sent including the following list of items for each frame.
  • FRAME ID
  • DATA TYPE(OBJECT, DARK, FLAT etc)
  • Object's Name
  • Right Ascension
  • Declination
  • Observation Date
  • Start Time of Exposures
  • Exposure Time(in seconds)
The query result listing in 'Detailed Query' includes the items from 'Simple Query' and also the custom keywords selected in 'Output Columns' from the Search Criteria Page..
If user selects 'Send the Result by e-mail' option, an e-mail includes the items from 'Data Transfer Mode - Simple Query Mode' and the custom keywords in 'Output Columns' from the Search Criteria Page.

If for any reason the user needs to stop the data transfer, push the 'Interrupt' button, and the user will be notified by e-mail.

Data transfer will not be stopped if the user closes the web browser after pressing 'Transfer'.

Transfer Check Page

The Transfer Check Page displays the status and progress of data transfer. By pushing the 'Check' button, the most recent transfer status will be displayed.

Calibration Data

If you took calibration data during your observation, it will be included in your query results for your Proposal ID. It is possible that calibration data was taken for another Proposal ID on the same night. If so, enter your observation date range in 5. Calibration data from dates below and retrieve other Proposal ID's calibration data from that night. Also, your Support Scientist may refer you to valid calibration data from a particular night. Select the 'Calibration Data from dates below' checkbox if you want other Proposal-ID's calibration data that were taken by the same instrument. Users may specify the date on which the calibration data were taken. Please contact your Support Scientist if you have questions about Calibration Frames for your proposal.

Any questions, comments, or problems are welcome to STARS & MASTARS administrators at starshelp@naoj.org.

Update: 2010/11/29 by Winegar (>3000 frames warning)
Update: 2009/02/13 by Winegar
Update: 2008/08/01 by Winegar
Update: 2006/05/03 by Winegar
Update: 2004/01/04 by Takata & Winegar
Update: 2002/03/06 by Tadafumi Takata & F.A.I.
operated by the
Subaru Telescope
National Astronomical Observatory of Japan
(www.naoj.org)

copyright 2008 - all rights reserved
Please contact the STARS & MASTARS administrators.
if you have any questions or comments about STARS.