Earth-Based Telescope 1.1.0.0 Discipline Ben Hirsch sbn ebt version 1.1.0 2023-11-15 - Updated to IM version 1.21.0.0 - Replaced apparent_visual_magnitude attribute with an Apparent_Magnitude class that can specify filter. - Added telescope_tracking_rate attribute to Instrument_Parameters to record Sidereal/Non-Sidereal tracking. - Promoted horizontal/vertical_coordinate_pixel attributes from World_Axis class to Reference_Frame_Parameters class. - Added specified_unit_id to attributes with minimum and maximum values (degrees for angles). - Removed redundant maximum length of 255 from attributes with ASCII_Short_String_Collapsed data type. - Changed attributes with a minimum of 0 or 1 to ASCII_NonNegative_Integer. - Removed unworkable schematron that required coordinate_system_equinox to be nil when Reference_Frame_Identification/name is either ICRS or GAPPT. - Added schematron rule to prohibit coordinate_system_equinox when Reference_Frame_Identification/name is either ICRS or GAPPT and another that requires coordinate_system_equinox when that's not the case. - coordinate_system_equinox is now nillable. 2023-11-15 magnitude_filter 1.0 magnitude_filter false SBN The filter in use (r', v', clear, etc.) at the time of the magnitude estimation. false ASCII_Short_String_Collapsed magnitude_value 1.0 magnitude_value false SBN The estimated magnitude at the time of observation. false ASCII_Real airmass 1.0 airmass false SBN Amount of air along the line of sight when observing a celestial target. Equivalent to one divided by the cosine of the zenith angle (in degrees). false ASCII_Real 0 Units_of_Optical_Path_Length airmass photometric 1.0 photometric false SBN The photometric attribute specifies whether observations at the time were considered photometric by the observer. false ASCII_Boolean observing_notes 1.0 observing_notes false SBN The observing_notes attribute is an optional field for describing the quality of the given observations. false ASCII_Short_String_Collapsed airmass_time 1.0 airmass_time true SBN The airmass_time attribute specifies the time at which the airmass was measured. false ASCII_Date_Time_YMD_UTC seeing_full_width_half_maximum 1.0 seeing_full_width_half_maximum false SBN This attribute specifies the FWHM of the seeing disk (e.g. a star). false ASCII_Real Units_of_Angle ambient_temperature 1.0 ambient_temperature false SBN The ambient_temperature attribute specifies the measured outside temperature during the observation. false ASCII_Real Units_of_Temperature ambient_pressure 1.0 ambient_pressure false SBN The ambient_pressure attribute specifies the measured outside pressure during the observation. false ASCII_Real Units_of_Pressure ambient_humidity 1.0 ambient_humidity false SBN The humidity attribute specifies the measured outside humidity during the observation, given as a percentage. false ASCII_Real 0 100 ambient_clouds 1.0 ambient_clouds false SBN The clouds attribute specifies the measured percentage of clouds present during the observation. false ASCII_Real 0 100 weather_notes 1.0 weather_notes false SBN The weather_notes attribute is an optional field for describing the weather during the observation. false ASCII_Short_String_Collapsed instrument_temperature 1.0 instrument_temperature false SBN The instrument_temperature attribute specifies the measured temperature of the instrument. false ASCII_Real Units_of_Temperature telescope_tracking_rate 1.0 telescope_tracking_rate false SBN The telescope_tracking_rate attribute identifies whether the telescope used for the observation was configured for sidereal tracking, object tracking, or some other tracking rate. false ASCII_Short_String_Collapsed name 1.0 name false SBN The name attribute provides a word or combination of words by which some feature is known. false ASCII_Short_String_Collapsed wcs_axes 1.0 wcs_axes false SBN A positive integer recording the number of WCS axes used in an image. false ASCII_Integer 1 Units_of_None coordinate_system_equinox 1.0 coordinate_system_equinox true SBN Time origin of the coordinate system. false ASCII_Real 1950 Units_of_None yr coordinate_system_celestial_pole_longitude 1.0 coordinate_system_celestial_pole_longitude false SBN Longitude in the native coordinate system of the system's celestial pole. false ASCII_Real 0 360 Units_of_Angle deg coordinate_system_celestial_pole_latitude 1.0 coordinate_system_celestial_pole_latitude false SBN Latitude in the native coordinate system of the system's celestial pole. false ASCII_Real -90 90 Units_of_Angle deg axis_index 1.0 axis_index false SBN Positive integer identifying which World_Axis is being described. false ASCII_NonNegative_Integer 1 Units_of_None coordinate_name 1.0 coordinate_name false SBN Name of the celestial coordinate to which this axis corresponds. false ASCII_Short_String_Collapsed coordinate_system_projection 1.0 coordinate_system_projection false SBN Name of the coordinate system projection used for this axis. true ASCII_Short_String_Collapsed Orthographic Equivalent to SIN. North Celestial Pole Equivalent to NCP. Gnomonic Equivalent to TAN. Zenithal Equidistant Equivalent to ARC. Stereographic Equivalent to STG. Hammer-Aitoff Equivalent to AIT. Sanson-Flamsteed Equivalent to GLS. Mercator Equivalent to MER. Gnomonic with distortion term Equivalent to TNX. Gnomonic with polynomial distortion Equivalent to TPV. Zenithal with distortion term Equivalent to ZPX. Gnomonic plus SIP Equivalent to TAN-SIP. Gnomonic with polynomial distortion plus SIP Equivalent to TPV-SIP. world_coordinate_reference_point 1.0 world_coordinate_reference_point false SBN World coordinate value at the reference point for this axis. false ASCII_Real -90 360 Units_of_Angle deg horizontal_axis 1.0 horizontal_axis false SBN The ebt:pixel_axis_index corresponding to the horizontal axis of an image. false ASCII_Integer 1 Units_of_None vertical_axis 1.0 vertical_axis false SBN The ebt:pixel_axis_index corresponding to the vertical axis of an image. false ASCII_Integer 1 Units_of_None world_axis_index 1.0 world_axis_index false SBN An axis of the world coordinate system used for an image, corresponding to the 'i' in the CDi_j formalism. false ASCII_Integer 1 Units_of_None pixel_axis_index 1.0 pixel_axis_index false SBN An axis of the pixel coordinate frame used for an image, corresponding to the 'j' in the CDi_j formalism. false ASCII_Integer 1 Units_of_None element_value 1.0 element_value false SBN The value of the matrix element corresponding to a given set of indices. false ASCII_Real Units_of_None parameter_number 1.0 parameter_number false SBN Integer between 0 and 99 corresponding to a particular non-linear algorithm used in a PV Distortion Matrix. false ASCII_NonNegative_Integer 99 Units_of_None polynomial_order 1.0 polynomial_order false SBN Integer between 2 and 9 corresponding to the order of distortion polynomial in an image using the SIP standard. false ASCII_Integer 2 9 Units_of_None p_polynomial_degree 1.0 p_polynomial_degree false SBN Integer value representing the degree of the polynomial term in a SIP distortion polynomial, the p in, f.e. A_p_q. false ASCII_NonNegative_Integer Units_of_None q_polynomial_degree 1.0 q_polynomial_degree false SBN Integer value representing the degree of the polynomial term in a SIP distortion polynomial, the q in, f.e. A_p_q. false ASCII_NonNegative_Integer Units_of_None vertical_coordinate_pixel 1.0 vertical_coordinate_pixel false Mitchell K. Gordon vertical_coordinate_pixel (line) is the vertical coordinate of a specific pixel. false ASCII_Real Units_of_Misc horizontal_coordinate_pixel 1.0 horizontal_coordinate_pixel false Mitchell K. Gordon horizontal_coordinate_pixel (sample) is the horizontal coordinate of a specific pixel. false ASCII_Real Units_of_Misc solar_phase_angle 1.0 solar_phase_angle false Ben Hirsch The solar_phase_angle attribute provides a measure of the relationship between the instrument viewing position and the sun. Solar phase angle is measured at the target; it is the angle between a vector to the sun and a vector to the instrument. false ASCII_Real 0 180 Units_of_Angle deg subsolar_latitude 1.0 subsolar_latitude false Ben Hirsch The subsolar_latitude attribute gives the value of the planetocentric latitude at the subsolar point on the target. false ASCII_Real -90 90 Units_of_Angle deg subsolar_longitude 1.0 subsolar_longitude false Ben Hirsch The subsolar_longitude attribute gives the value of the planetocentric longitude at the subsolar point on the target. false ASCII_Real 0 360 Units_of_Angle deg subobserver_latitude 1.0 subobserver_latitude false Ben Hirsch The subobserver_latitude attribute gives the value of the planetocentric latitude at the subobserver point on the target. false ASCII_Real -90 90 Units_of_Angle deg subobserver_longitude 1.0 subobserver_longitude false Ben Hirsch The subobserver_longitude attribute gives the value of the planetocentric longitude at the subobserver point on the target. false ASCII_Real 0 360 Units_of_Angle deg frame_spice_name 1.0 frame_spice_name false Mitchell K. Gordon The frame_spice_name attribute is a NAIF-recognized string identifier for a reference frame associated with the data. false ASCII_Short_String_Collapsed Earth_Based_Telescope_Parameters 1.0 Earth_Based_Telescope_Parameters SBN This class is intended to provide additional metadata for earth-based telescopic observations. Much of the information is geometry information, but in an earth-based context. true Apparent_Magnitude component_of 0 * Telescope_Geometry component_of 0 1 Instrument_Parameters component_of 0 1 Observing_Conditions component_of 0 1 Apparent_Magnitude 1.0 Apparent_Magnitude SBN The Apparent_Magnitude class is an optional, repeatable class for recording magnitude measurements made for an observation. false false magnitude_filter attribute_of 1 1 magnitude_value attribute_of 1 1 Telescope_Geometry 1.0 Telescope_Geometry SBN The Geometry_Telescope class is a container for geometric information relevant to ground-based observations, as well as observations made from Earth-orbiting telescopes. false false World_Coordinate_System component_of 0 1 Target_Geometry component_of 0 1 Instrument_Parameters 1.0 Instrument_Parameters SBN This class contains instrument settings and statuses relevant to the observation. false instrument_temperature attribute_of 0 1 telescope_tracking_rate attribute_of 0 1 Observing_Conditions 1.0 Observing_Conditions SBN This class details the quality of the product based on observational conditions. false photometric attribute_of 0 1 Airmass component_of 0 1 Seeing component_of 0 1 Weather component_of 0 1 observing_notes attribute_of 0 1 World_Coordinate_System 1.0 World_Coordinate_System SBN This class contains World Coordinate System (WCS) terms as specified by the FITS standard for the purpose of mapping the pixel coordinate frame of an image onto a celestial frame. false false Reference_Frame_Parameters component_of 1 1 Coordinate_Frame_Transformation_Matrix component_of 1 1 PV_Distortion_Matrix component_of 0 1 SIP_Distortion_Terms component_of 0 1 Target_Geometry 1.0 Target_Geometry SBN This class contains attributes that describe angles and points in reference to the target. false false solar_phase_angle attribute_of 0 1 subsolar_latitude attribute_of 0 1 subsolar_longitude attribute_of 0 1 subobserver_latitude attribute_of 0 1 subobserver_longitude attribute_of 0 1 Reference_Frame_Parameters 1.0 Reference_Frame_Parameters SBN This class contains reference terms that define the WCS axes used in an image. false false wcs_axes attribute_of 1 1 coordinate_system_equinox attribute_of 0 1 coordinate_system_celestial_pole_longitude attribute_of 1 1 coordinate_system_celestial_pole_latitude attribute_of 1 1 vertical_coordinate_pixel attribute_of 1 1 horizontal_coordinate_pixel attribute_of 1 1 World_Axis component_of 1 * Reference_Frame_Identification component_of 1 1 World_Axis 1.0 World_Axis SBN This class contains attributes that describe an individual world axis as used in an image. false false axis_index attribute_of 1 1 coordinate_name attribute_of 1 1 coordinate_system_projection attribute_of 1 1 world_coordinate_reference_point attribute_of 1 1 Reference_Frame_Identification 2.0 Reference_Frame_Identification Elizabeth Rye The Reference_Frame_Identification class is a base class for identifying reference frames. These are frames in the NAIF sense, i.e., three orthogonal axes with a specified orientation, but without a fixed origin. false false frame_spice_name attribute_of 0 1 name attribute_of 0 1 pds.comment attribute_of 0 1 pds.Internal_Reference component_of 0 1 Coordinate_Frame_Transformation_Matrix 1.0 Coordinate_Frame_Transformation_Matrix SBN Container class for the elements of a linear transformation matrix between the world coordinate frame and the pixel coordinate frame. false false Pixel_Axes component_of 1 1 Transformation_Element component_of 1 * Pixel_Axes 1.0 Pixel_Axes SBN Class containing attributes that link the value of ebt:pixel_axis_index with the horizontal and vertical axes of an image. false false horizontal_axis attribute_of 1 1 vertical_axis attribute_of 1 1 Transformation_Element 1.0 Transformation_Element SBN Class containing the value of an element of a linear transformational matrix between the world_axis_index and pixel_axis_index. false false world_axis_index attribute_of 1 1 pixel_axis_index attribute_of 1 1 element_value attribute_of 1 1 PV_Distortion_Matrix 1.0 PV_Distortion_Matrix SBN This class contains elements of a distortion matrix. false false Distortion_Element component_of 1 * Distortion_Element 1.0 Distortion_Element SBN This class contains attributes for the axis, parameter, and value of an element in a PV distortion matrix. false false world_axis_index attribute_of 1 1 parameter_number attribute_of 1 1 element_value attribute_of 1 1 SIP_Distortion_Terms 1.0 SIP_Distortion_Terms SBN This class contains subclasses representing the distortion terms used in the SIP standard. false false A_ORDER component_of 1 1 B_ORDER component_of 1 1 AP_ORDER component_of 0 1 BP_ORDER component_of 0 1 A_ORDER 1.0 A_ORDER SBN Representation of the non-linear geometric distortion -- polynomial order of the first world axis. false false polynomial_order attribute_of 1 1 SIP_Element component_of 1 * B_ORDER 1.0 B_ORDER SBN Representation of the non-linear geometric distortion -- polynomial order of the second world axis. false false polynomial_order attribute_of 1 1 SIP_Element component_of 1 * AP_ORDER 1.0 AP_ORDER SBN Representation of the non-linear geometric distortion -- inverse polynomial order of the first pixel axis. false false polynomial_order attribute_of 1 1 SIP_Element component_of 1 * BP_ORDER 1.0 BP_ORDER SBN Representation of the non-linear geometric distortion -- inverse polynomial order of the second pixel axis. false false polynomial_order attribute_of 1 1 SIP_Element component_of 1 * SIP_Element 1.0 SIP_Element SBN Class containing the value of an element of a SIP distortion polynomial, with element_value corresponding to the actual coefficient. false false p_polynomial_degree attribute_of 1 1 q_polynomial_degree attribute_of 1 1 element_value attribute_of 1 1 Airmass 1.0 Airmass SBN This class describes parameters relevant to the airmass during observations. false airmass attribute_of 1 1 airmass_time attribute_of 1 1 Seeing 1.0 Seeing SBN This class describes parameters relevant to the seeing during observations. false seeing_full_width_half_maximum attribute_of 1 1 Weather 1.0 Weather SBN This class describes parameters relevant to the weather during observations. false ambient_temperature attribute_of 0 1 ambient_pressure attribute_of 0 1 ambient_humidity attribute_of 0 1 ambient_clouds attribute_of 0 1 weather_notes attribute_of 0 1 Reference_Frame_Identification_0 //ebt:Reference_Frame_Identification Assert if (not(ebt:frame_spice_name) and not (ebt:name) and not (pds:Internal_Reference)) then false() else true() At least one of the following must be present: ebt:frame_spice_name, ebt:name, pds:Internal_Reference. Reference_Frame_Identification_1 //ebt:Reference_Frame_Identification/pds:Internal_Reference Assert pds:reference_type = 'geometry_to_reference_frame' For Internal_Reference in ebt:Reference_Frame_Identification, reference_type must equal 'geometry_to_reference_frame' World_Coordinate_System_0 ebt:World_Coordinate_System Assert if ((ebt:Reference_Frame_Parameters/ebt:World_Axis/ebt:coordinate_system_projection = ('Gnomonic with polynomial distortion', 'Gnomonic with polynomial distortion plus SIP')) and not (ebt:PV_Distortion_Matrix)) then false() else true() If ebt:coordinate_system_projection includes polynomial distortion, you must use the ebt:PV_Distortion_Matrix class. Assert if ((ebt:Reference_Frame_Parameters/ebt:World_Axis/ebt:coordinate_system_projection = ('Gnomonic plus SIP', 'Gnomonic with polynomial distortion plus SIP')) and not (ebt:SIP_Distortion_Terms)) then false() else true() If ebt:coordinate_system_projection includes 'plus SIP', you must use the ebt:SIP_Distortion_Terms class. Reference_Frame_Parameters_0 ebt:World_Coordinate_System/ebt:Reference_Frame_Parameters Assert if (ebt:Reference_Frame_Identification/ebt:name = ('GAPPT', 'ICRS') and ebt:coordinate_system_equinox) then false() else true() If ebt:Reference_Frame_Identification/ebt:name = GAPPT or ICRS, then ebt:coordinate_system_equinox must not be present. Assert if (not(ebt:Reference_Frame_Identification/ebt:name = ('GAPPT', 'ICRS')) and not(ebt:coordinate_system_equinox)) then false() else true() If ebt:Reference_Frame_Identification/ebt:name != GAPPT or ICRS, then ebt:coordinate_system_equinox must be present. Assert ebt:wcs_axes = count(ebt:World_Axis) The number of ebt:World_Axis elements must match the number found in the ebt:wcs_axes attribute.