exposure-1.0.0
Exposure Information
Outline
Schema Definitions ¶
This type is an object with the following properties:
type
asdf://stsci.edu/datamodels/roman/schemas/exposure_type-1.0.0 Required start_time
tag:stsci.edu:asdf/time/time-1.* Required The UTC time at the beginning of the exposure.
ngroups
integer Required The number of resultant frames in this exposure that were transmitted to the ground. The number of integrations of WFI data is always 1.
nframes
integer Required This is the number of science frames that are combined to produce a resultant frame.
data_problem
boolean Required A flag indicating an issue with science telemetry.
frame_divisor
integer Required The number of reads averaged to calculate a resultant. Value depends on the readout pattern used from the MultiAccum table.
groupgap
integer Required The number of reads that are dropped, or not used to calculate a resultant.
frame_time
number Required The amount of time elapsed between the end of one read and the beginning of the next.
group_time
number Required The time that is the sum of the reads that are used to construct a resultant. This will depend on the MA table being used.
exposure_time
number Required The time between the start of the first Reset/Read Science Frame of an Exposure and the completion of the final Read Only Science Frame of that Exposure.
ma_table_name
string Required No length restrictionThe name of the MultiAccum table used for this exposure, as defined in the Project Reference Database.
ma_table_number
integer Required The number of the MultiAccum table used for this exposure. Used in matching exposures to their corresponding calibration data.
read_pattern
array Required No length restrictionEnumeration of detector reads to resultants making up the L1 data downlinked from the observatory.
Items in the array are restricted to the following types:
No length restrictionarray
Items in the array are restricted to the following types:
integer
id
integer Required The matching exposure ID for a given visit ID.
mid_time
tag:stsci.edu:asdf/time/time-1.* Required The UTC time at the midpoint of the exposure.
end_time
tag:stsci.edu:asdf/time/time-1.* Required The UTC time at the end of the exposure.
start_time_mjd
number Required The date, in MJD, at the beginning of this exposure. Used in the archive catalog for multi-mission matching.
mid_time_mjd
number Required The date, in MJD, at the midpoint of this exposure. Used in the archive catalog for multi-mission matching.
end_time_mjd
number Required The date, in MJD, at the end of this exposure. Used in the archive catalog for multi-mission matching.
start_time_tdb
number Required The date, in TDB (Barycentric Dynamical Time), at the beginning of this exposure.
mid_time_tdb
number Required The date, in TDB (Barycentric Dynamical Time), at the midpoint of this exposure.
end_time_tdb
number Required The date, in TDB (Barycentric Dynamical Time), at the end of this exposure.
sca_number
integer Required The number of the detector on the Sensor Chip Assembly used for this exposure.
gain_factor
number Required integration_time
number Required The effective amount of time that the sensor was exposed to the sky.
elapsed_exposure_time
number Required The amount of time elapsed between an exposure’s first and last science reads.
effective_exposure_time
number Required The amount of time during which the detector actually collected photons during an exposure.
duration
number Required The amount of time dedicated to a exposure, including any overhead, time spent on dropped frames, and so on.
level0_compressed
boolean Required A flag indicating that the exposure has data that was decompressed by the ground system.
truncated
boolean A flag indicating whether the MA table was truncated.
Original Schema ¶
%YAML 1.1
---
$schema: asdf://stsci.edu/datamodels/roman/schemas/rad_schema-1.0.0
id: asdf://stsci.edu/datamodels/roman/schemas/exposure-1.0.0
title: |
Exposure Information
type: object
properties:
type:
$ref: asdf://stsci.edu/datamodels/roman/schemas/exposure_type-1.0.0
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: nvarchar(25)
destination: [WFIExposure.exposure_type, GuideWindow.exposure_type, WFICommon.exposure_type]
start_time:
title: Exposure Start Time (UTC)
description: |
The UTC time at the beginning of the exposure.
tag: tag:stsci.edu:asdf/time/time-1.*
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: datetime2
destination: [WFIExposure.exposure_start_time, GuideWindow.exposure_start_time, WFICommon.exposure_start_time]
ngroups:
title: Number of Resultants
description: |
The number of resultant frames in this exposure that were transmitted to
the ground. The number of integrations of WFI data is always 1.
type: integer
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: int
destination: [WFIExposure.exposure_ngroups, GuideWindow.exposure_ngroups, WFICommon.exposure_ngroups]
nframes:
title: Number of Reads
description: |
This is the number of science frames that are combined to produce a resultant frame.
type: integer
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: int
destination: [WFIExposure.exposure_nframes, GuideWindow.exposure_nframes, WFICommon.exposure_nframes]
data_problem:
title: Data Problem
description: |
A flag indicating an issue with science telemetry.
type: boolean
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: nchar(1)
destination: [WFIExposure.exposure_data_problem, GuideWindow.exposure_data_problem, WFICommon.exposure_data_problem]
frame_divisor:
title: Frame Divisor
description: |
The number of reads averaged to calculate a resultant. Value depends on
the readout pattern used from the MultiAccum table.
type: integer
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: int
destination: [WFIExposure.exposure_frame_divisor, GuideWindow.exposure_frame_divisor, WFICommon.exposure_frame_divisor]
groupgap:
title: Number of Frames Dropped Between Resultants
description:
The number of reads that are dropped, or not used to calculate a
resultant.
type: integer
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: int
destination: [WFIExposure.exposure_groupgap, GuideWindow.exposure_groupgap, WFICommon.exposure_groupgap]
frame_time:
title: Time Between Reads (s)
description: |
The amount of time elapsed between the end of one read and the beginning
of the next.
type: number
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: float
destination: [WFIExposure.exposure_frame_time, GuideWindow.exposure_frame_time, WFICommon.exposure_frame_time]
group_time:
title: Time Between Resultants (s)
description: |
The time that is the sum of the reads that are used to construct a
resultant. This will depend on the MA table being used.
type: number
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: float
destination: [WFIExposure.exposure_group_time, GuideWindow.exposure_group_time, WFICommon.exposure_group_time]
exposure_time:
title: Exposure Time (s)
description: |
The time between the start of the first Reset/Read Science Frame of an
Exposure and the completion of the final Read Only Science Frame of that
Exposure.
type: number
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: float
destination: [WFIExposure.exposure_time, GuideWindow.exposure_time, WFICommon.exposure_time]
ma_table_name:
title: MA Table Name
description: |
The name of the MultiAccum table used for this exposure, as defined in the
Project Reference Database.
type: string
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: nvarchar(50)
destination: [WFIExposure.ma_table_name, GuideWindow.ma_table_name, WFICommon.ma_table_name]
ma_table_number:
title: MA Table Number
description: |
The number of the MultiAccum table used for this exposure. Used in
matching exposures to their corresponding calibration data.
type: integer
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: smallint
destination: [WFIExposure.ma_table_number, GuideWindow.ma_table_number, WFICommon.ma_table_number]
read_pattern:
title: Read Pattern
description: |
Enumeration of detector reads to resultants making up the L1 data
downlinked from the observatory.
type: array
items:
type: array
items:
type: integer
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: nvarchar(3500)
destination: [WFIExposure.read_pattern, GuideWindow.read_pattern, WFICommon.read_pattern]
id:
title: Visit Exposure ID
description: |
The matching exposure ID for a given visit ID.
type: integer
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: int
destination: [WFIExposure.exposure_id, GuideWindow.exposure_id,
SourceCatalog.exposure_id]
mid_time:
title: Exposure Mid Time (UTC)
description: |
The UTC time at the midpoint of the exposure.
tag: tag:stsci.edu:asdf/time/time-1.*
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: datetime2
destination: [WFIExposure.exposure_mid_time, GuideWindow.exposure_mid_time,
SourceCatalog.exposure_mid_time]
end_time:
title: Exposure End Time (UTC)
description: |
The UTC time at the end of the exposure.
tag: tag:stsci.edu:asdf/time/time-1.*
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: datetime2
destination: [WFIExposure.exposure_end_time, GuideWindow.exposure_end_time,
SourceCatalog.exposure_end_time]
start_time_mjd:
title: MJD Start Time (d)
description: |
The date, in MJD, at the beginning of this exposure. Used in the archive
catalog for multi-mission matching.
type: number
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: float
destination: [WFIExposure.exposure_start_time_mjd, GuideWindow.exposure_start_time_mjd,
SourceCatalog.exposure_start_time_mjd]
mid_time_mjd:
title: MJD Mid Time (d)
description: |
The date, in MJD, at the midpoint of this exposure. Used in the archive
catalog for multi-mission matching.
type: number
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: float
destination: [WFIExposure.exposure_mid_time_mjd, GuideWindow.exposure_mid_time_mjd,
SourceCatalog.exposure_mid_time_mjd]
end_time_mjd:
title: MJD End Time (d)
description: |
The date, in MJD, at the end of this exposure. Used in the archive catalog
for multi-mission matching.
type: number
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: float
destination: [WFIExposure.exposure_end_time_mjd, GuideWindow.exposure_end_time_mjd,
SourceCatalog.exposure_end_time_mjd]
start_time_tdb:
title: TDB Start Time (d)
description: |
The date, in TDB (Barycentric Dynamical Time), at the beginning of this
exposure.
type: number
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: float
destination: [WFIExposure.exposure_start_time_tdb, GuideWindow.exposure_start_time_tdb,
SourceCatalog.exposure_start_time_tdb]
mid_time_tdb:
title: TDB Mid Time (d)
description: |
The date, in TDB (Barycentric Dynamical Time), at the midpoint of this
exposure.
type: number
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: float
destination: [WFIExposure.exposure_mid_time_tdb, GuideWindow.exposure_mid_time_tdb,
SourceCatalog.exposure_mid_time_tdb]
end_time_tdb:
title: TDB End Time (d)
description: |
The date, in TDB (Barycentric Dynamical Time), at the end of this
exposure.
type: number
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: float
destination: [WFIExposure.exposure_end_time_tdb, GuideWindow.exposure_end_time_tdb,
SourceCatalog.exposure_end_time_tdb]
sca_number:
title: SCA Number
description: |
The number of the detector on the Sensor Chip Assembly used for this
exposure.
type: integer
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: int
destination: [WFIExposure.exposure_sca_number, GuideWindow.exposure_sca_number,
SourceCatalog.exposure_sca_number]
gain_factor:
title: Gain Factor
type: number
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: float
destination: [WFIExposure.exposure_gain_factor, GuideWindow.exposure_gain_factor,
SourceCatalog.exposure_gain_factor]
integration_time:
title: Effective Integration Time (s)
description:
The effective amount of time that the sensor was exposed to the sky.
type: number
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: float
destination: [WFIExposure.exposure_integration_time, GuideWindow.exposure_integration_time,
SourceCatalog.exposure_integration_time]
elapsed_exposure_time:
title: Elapsed Exposure Time (s)
description: |
The amount of time elapsed between an exposure's first and last science
reads.
type: number
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: float
destination: [WFIExposure.elapsed_exposure_time, GuideWindow.elapsed_exposure_time,
SourceCatalog.elapsed_exposure_time]
effective_exposure_time:
title: Effective Exposure Time (s)
description: |
The amount of time during which the detector actually collected photons
during an exposure.
type: number
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: float
destination: [WFIExposure.effective_exposure_time, GuideWindow.effective_exposure_time,
SourceCatalog.effective_exposure_time]
duration:
title: Exposure Duration (s)
description: |
The amount of time dedicated to a exposure, including any overhead, time
spent on dropped frames, and so on.
type: number
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: float
destination: [WFIExposure.exposure_duration, GuideWindow.exposure_duration,
SourceCatalog.exposure_duration]
level0_compressed:
title: Level 0 Compression
description: |
A flag indicating that the exposure has data that was decompressed by the
ground system.
type: boolean
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: nchar(1)
destination: [WFIExposure.exposure_level0_compressed, GuideWindow.exposure_level0_compressed,
SourceCatalog.exposure_level0_compressed]
truncated:
title: Truncated MA Table
description: |
A flag indicating whether the MA table was truncated.
type: boolean
sdf:
special_processing: VALUE_REQUIRED
source:
origin: TBD
archive_catalog:
datatype: nchar(1)
destination: [WFIExposure.exposure_truncated,
SourceCatalog.exposure_truncated]
required: [type, start_time,
ngroups, nframes, data_problem,
frame_divisor, groupgap, frame_time, group_time, exposure_time,
ma_table_name, ma_table_number, read_pattern, id,
mid_time, end_time,
start_time_mjd, mid_time_mjd, end_time_mjd,
start_time_tdb, mid_time_tdb, end_time_tdb,
sca_number,
gain_factor, integration_time, elapsed_exposure_time,
effective_exposure_time, duration,
level0_compressed]
propertyOrder: [type, start_time,
ngroups, nframes, data_problem,
frame_divisor, groupgap, frame_time, group_time, exposure_time,
ma_table_name, ma_table_number, read_pattern, id,
mid_time, end_time,
start_time_mjd, mid_time_mjd, end_time_mjd,
start_time_tdb, mid_time_tdb, end_time_tdb,
sca_number,
gain_factor, integration_time, elapsed_exposure_time,
effective_exposure_time, duration,
level0_compressed, truncated]
flowStyle: block
...