ISIM ASIC Tuning Template Parameters
JWST's ISIM ASIC Tuning Template, available in the Astronomer’s Proposal Tool (APT), is used to execute onboard ASIC tuning studies with a user-specified configuration file for either FGS, NIRCam, NIRISS or NIRSpec (MIRI does not have any ASICs).
Purple text indicates the parameter is Limited Access.
Boldface italics type indicates the name of an APT parameter or a value for a parameter.
Red text indicates restrictions on a parameter.
Black text indicates an important note.
Brown text indicates notes for the developers.
Green text indicates the name of the parameter used by Commanding.
Items in brackets - <value> - are required values.
Items in square brackets - [<value>] - are optional.
The ISIM ASIC Tuning template is to be used by the Commanding Team to execute onboard ASIC tuning studies with a user-specified configuration file for either FGS, NIRCam, NIRISS or NIRSpec (MIRI does not have any ASICs).
ISIM ASIC Tuning observation(s) may be scheduled with a parallel SI or in parallel with other ASIC tuning observation(s), except for NIRCam ASIC Tuning, which must be scheduled as a prime visit and no parallel SI operation (TBD). Note that there is mechanism motion by the user-specified SI during the ASIC tuning visit and that OSS will prevent mechanism motion from occurring during a parallel SI exposure.
In addition to the following template parameters, this template will have the Special Requirements NO PARALLEL and REQUIRED added by default.
The following parameters are used to define ISIM ASIC Tuning observations.
| Field | Details | Value | Notes |
|---|---|---|---|
| General Information | |||
| Observation Number | assign observation number | number | |
| Observation Label | provide observation label | text | |
| Observation Comments | provide observation comments | text | |
| Target Name | default value | NONE | |
| Special Requirements | specify special requirements | choose from list | if needed |
| Template specific information | |||
| Science Instrument | select a science instrument | choose from list | |
| ASIC Tuning File Name | specify an ASIC tuning file name | text | |
| Data Volume | specify a data volume | number | Mebibytes (MiB) |
| Duration | specify an ASIC tuning duration | number | |
General Information
The following parameters are generic to all templates, and are not discussed in this article: Observation Number, Observation Label, Observations Comments, Target Name, and Special Requirements.
Science Instrument
SCIENCE INSTRUMENT [INSTRUMENT] = FGS1, FGS2, NIRCAM, NIRISS, NIRSPEC
This field specifies the science instrument configured by ASIC Tuning file. This field is used for scheduling purposes only.
ASIC Tuning File Name
This parameter is used to specify the ASIC tuning FILE NAME [FILE_NAME] with extension (e.g. NRCCMB_003.atu). Note that OPGS will automatically prefix "ram:/" to the filename when generating the visit file.
Data Volume
This parameter specifies the DATA VOLUME [DATA_VOLUME_MIB] generated by the ASIC tuning file in Mebibytes (10242 bytes).
Note to developer: This value is a non-negative integer with no default or upper limit. The label for the field should be MiB.
Duration
This parameter specifies the DURATION [DURATION] needed to execute the ASIC Tuning visit. Any duration ≥ 1 second is allowed. Select units of Days, Hours, Minutes, or Seconds.
Note to developers: This value is a positive real number with no upper limit.
Note to developers: APT should automatically set Target to NONE.
Note for developers: The database visit table values should be:
internal_target = 'Y'
external_target = 'N'
pcs_mode = 'NONE'
schedule_as_parallel = 'N' (TBD)
parallels_allowed = 'N' (TBD)
realtime = 'N'
required = 'Y' -> Special Requirement
science_duration = duration specified by user
overhead_duration = 0
scheduling_duration = duration specified by user
charged_duration = duration specified by user
(All other duration fields in the "visit" relation = 0)