Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DraftMASTDOCS and version 23.10
Excerpt
hiddentrue

Anchor
core_params
core_params

Core Search Parameters

Some parameters are used on multiple search forms. The most common of these are reproduced below.

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2
borderStylesolid

Table of Contents
maxLevel3
minLevel2
indent24px

Anchor
comp_expduration
comp_expduration

Exposure Duration

Used with: 

Status
subtletrue
colourGrey
titleHST
 
Status
subtletrue
titleJWST

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

The 'Exposure Time' component, a Numeric field, allows querying for observations based on exposure durations, in seconds. Type a number, conditional operation, or a range.

Anchor
comp_obsdate
comp_obsdate

Observed Date

Used with:

Status
subtletrue
colourGrey
titleHST
 
Status
subtletrue
titleJWST
 
Status
subtletrue
titleULLYSES

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

The 'Observation Start Date' Component is a DateTime field.

To constrain data by Date and/or Time, use the format: yyyy-mm-dd in the 'Obs Start Date' field and hh:mm:ss in the 'Time' field. Note the 'Time' field is not required.

Shortcuts are available in these fields. Entering just a year in the 'Obs Start Date' field will default to January 1st of the year, e.g., entering just '2001' is the same as entering '2001-01-01'. Entering just a year and month will default to the 1st of that month, e.g., entering just '2001-04' is the same as entering '2001-04-01'. Entering partial times will fill in the rest with zeroes, e.g., entering '15' in the 'Time' field is the same as entering '15:00:00', and entering '11:30' is the same as entering '11:30:00'.

In addition to directly typing in an exact date/time, this component offers a built-in calendar and clock to set the parameters.

Anchor
comp_principalinv
comp_principalinv
Principal Investigator

Used with:

Status
subtletrue
colourGrey
titleHST
 
Status
subtletrue
titleJWST

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Example of a type-ahead search result for PI surnames that start with 'WH'.

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

The 'Principal Investigator' component is a String field. Type an exact surname or a character string to enable a type-ahead menu. Once the type-ahead menu pops out, scroll through the surname list and select a name. 'Wildcard' search, 'Exclude' search, and search by 'Multiple' entries are allowed, but will not work with the type-ahead drop-down list.

Anchor
comp_programid
comp_programid
Proposal ID

Used With:

Status
subtletrue
colourGrey
titleHST
 
Status
subtletrue
titleJWST

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

The 'Proposal ID' component allows search by proposal ID number(s) assigned to observation(s). Note that for some data collections, this might refer to Proposal ID or Guest Investigator ID.

This component is a Numeric field, so it allows an exact match, conditional search (for example, >= 14657) or a range search (for example, 12500 .. 12600). Type the Proposal ID with a preferred numeric search operation.

Anchor
comp_reldate
comp_reldate
Release Date

Used With:

Status
subtletrue
colourGrey
titleHST
 
Status
subtletrue
titleJWST
 

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Much like the Observed Date component, 'Release Date' is also a DateTime field. An Observation is considered "released" when it becomes available to people outside the Principal Investigator Team; depending on the exclusive access period, this could be instant or take up to a year.

See the Observed Date component for tips on how to use this component.

Anchor
comp_spec_elem
comp_spec_elem
Spectral Element

Used With:

Status
subtletrue
colourGrey
titleHST
 
Status
subtletrue
titleJWST
 
Status
subtletrue
titleULLYSES

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Example of a type-ahead search result for Filters/Gratings that start with 'G13'.


Example of 3 filter/grating entries: an exact match of POL120, a wildcard search on G*, and an exclusion of G130M.

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

The 'Spectral Element' refers to filters, gratings, both, or combination filter sets such as 'POL120UV;F330W' depending on the data collection.

One or more filters or gratings can be entered into the 'Filters/ Gratings' box. Press 'tab', 'return', or 'comma' on your keyboard to finish entering the filter/grating name (clicking off the text box will also work).

  • Upon entering a filter/grating, it will be added and surrounded by a light-blue color.  The filter/grating shown will be included as a search filter.

           

  • The 'X' mark right next to each entry can used to remove a filter/grating.

This field supports type-ahead. Once a key is pressed, a list of filters/gratings that contain that text will be shown. Browse through the suggested list to find the one being searched for, and then click to select it.

Since there are many options for searching based on the filter/grating list, we expand the description with more examples below. This component is a String Field, so there are various ways to constrain the search. Below are some examples of how to use these constraints. Experiment with other options for further constraining the search.

Examples of Spectral Element Searches

OperationExamplesNote
Exact match

G130M

Type an exact name of the filter, grating, or the combination filter set to retrieve only observations associated with the input string.

Tip

Combination filter sets are delimited by a semicolon (;). Remember that combination sets are single strings.

MIRRORA
POL120UV;F330W
F2ND;CLEAR2;F1ND;F372M
Wildcard

G*M

This example retrieves observations that used grating names starting with 'G' and ending with 'M' such as 'G150M' or 'G220M'.

F81*

Since a combination filter set is considered as a single string, the input wildcard characters 'F81*' retrieve all observations associated with the filter 'F814W' and the other ones such as 'F814W;POLQN18 and 'F814W;F791W'.

MultipleG130M, F550W

The 'Multiple' operator (',') acts as the logical operator 'OR'. Thus this example retrieves observations used the grating 'G130M' or the filter 'F550W'.


F550W,POL60UV;PR200L

This example retrieves observations used the filter 'F550W' or the combination filter set 'POL60UV;PR200L'.

Warning

Be sure to use the 'Multiple' operator, comma (,) not a semicolon (;) used for appending filters for combination filter set names.

Exclude!F550W

This operation excludes any observations using the filter 'F550W'.

G*,!G140L

This search retrieves observations using all grating options ('G*) except the grating 'G140L'.

Type ahead
Note
titleType ahead limitation

Note that this only shows a list of single spectral elements and not combination filter sets.