SBN Discipline Dictionary
Contents
- 1 Small Bodies Discipline Dictionary
- 1.1 Current Classes
- 1.2 Current Attributes
- 1.2.1 startJulianDate
- 1.2.2 stopJulianDate
- 1.2.3 midJulianDate
- 1.2.4 filterName
- 1.2.5 centerWavelength
- 1.2.6 airmass
- 1.2.7 rightAscension
- 1.2.8 declination
- 1.2.9 exposureTime
- 1.2.10 pixelFOV
- 1.2.11 timeFromClosestApproach
- 1.2.12 geometryNote
- 1.2.13 SPICEFileNames
- 1.2.14 targetSpacecraftPosition
- 1.2.15 targetSpacecraftVelocity
- 1.2.16 targetCenterDistance
- 1.2.17 spacecraftHeliocentricDistance
- 1.2.18 spacecraftSunPosition
- 1.2.19 spacecraftHeliocentricVelocity
- 1.2.20 targetHeliocentricDistance
- 1.2.21 targetSunPosition
- 1.2.22 targetHeliocentricVelocity
- 1.2.23 spacecraftGeocentricDistance
- 1.2.24 spacecraftEarthPosition
- 1.2.25 targetGeocentricDistance
- 1.2.26 earthTargetPosition
- 1.2.27 earthTargetVelocity
- 1.2.28 phaseAngle
- 1.2.29 celestialNorthClockAngle
- 1.2.30 solarNorthPoleClockAngle
Small Bodies Discipline Dictionary
This dictionary should contain classes and attributes specific to small bodies research. It should not contain things that are better defined in the context of the mission or things that should be in some other discipline-specific dictionary - the the exception of geometry. We will be incorporating geometric parameters into our mock-up dictionary until it becomes clear how geometry should be handled across the PDS.
I'll be building the dictionary schema - the file we'll use to validate labels - by hand until a real dictionary tool exists. The first part of this page lists classes and attributes already in the dictionary. I'll need formal definitions for these, so please fill them in if you can.
The second part of this page is for requesting new additions to the dictionary. You must provide a name for the attribute, a data type, a definition, and any constraints necessary for validation (extrema, for example). Attributes should be collected into classes of related concepts where that makes sense. Classes can be added at the end of the attribute list. Follow the form of the #Current Attributes section when adding new entries.
Current Classes
Attributes should be grouped into classes. Classes are named using camel case with the first letter capitalized. Attributes are considered required unless otherwise indicated.
JulianDates
Julian date equivalents of observation times
- startJulianDate - optional
- stopJulianDate - optional
- midJulianDate - optional
Filter
Simple filter description
GroundbasedParameters
General ground-based observing parameters
- Filter (class) - optional
- airmass
- rightAscension
- declination
- exposureTime
- pixelFOV
Geometry
Catch-all geometry class - though perhaps this should be divided into ground-based and spacecraft classes?
- geometryNote
- SPICEFileNames
- targetCenterDistance
- targetSpacecraftPosition
- targetSpacecraftVelocity
- spacecraftHeliocentricDistance
- spacecraftSunPosition
- spacecraftSunVelocity
- targetHeliocentricDistance
- targetSunPosition
- targetSunVelocity
- spacecraftGeocentricDistance
- spacecraftEarthPosition
- earthTargetPosition
- earthTargetVelocity
Current Attributes
Please do edit any and all of these definitions as warranted.
startJulianDate
- Type: Double-precision float
- Definition: Full Julian date of the start point of an observation.
stopJulianDate
- Type: Double-precision float
- Definition: Full Julian date of the end point of an observation.
midJulianDate
- Type: Double-precision float
- Definition: Full Julian date of the mid-point of an observation.
filterName
- Type: String
- Definition:
centerWavelength
- Type: Float
- Unit Type: Length
- Definition: Center wavelength of the filter bandpass
airmass
- Type: Double-precision float
- Unit Type: airmass
- Minimum: 1.00
- Definition:
rightAscension
- Type: Double-precision float
- Unit Type: degrees
- Minimum: 0.00
- Maximum: 360.00
- Definition: Right ascension, in degrees
declination
- Type: Double-precision float
- Unit Type: degrees
- Minimum: -90.00
- Maximun: 90.00
- Definition: Declination, in degrees
exposureTime
- Type: Float
- Unit Type: Time
- Minimum: 0.00
- Definition:
pixelFOV
- Type: Float
- Unit Type: Angle
- Minimum: 0.00
- Definition:
timeFromClosestApproach
- Type: Double-precision float
- Unit Type: Time
- Definition:
geometryNote
- Type: String, white space preserved
- Definition: A place for comments specific to the attributes in the geometry class
SPICEFileNames
- Type: String, white-space delimited file names
- Definition: A list of SPICE kernels used for calculating the associated geometry
targetSpacecraftPosition
- Type: 3-vector of double-precision floats
- Unit Type: Distance - fixed to km
- Definition: Distance measured from the center of mass of the target to the center of mass of the spacecraft
targetSpacecraftVelocity
- Type: 3-vector of double-precision floats
- Unit Type: Distance - fixed to km/s
- Definition:
targetCenterDistance
- Type: double-precision float
- Unit Type: Length
:Definition:
spacecraftHeliocentricDistance
- Type: double-precision float
- Unit Type: Length
- Definition:
spacecraftSunPosition
- Type: 3-vector of double-precision floats
- Unit Type: Distance - fixed to km
- Definition:
spacecraftHeliocentricVelocity
- Unit Type: Distance - fixed to km/s
- Definition:
targetHeliocentricDistance
- Type: double-precision float
- Unit Type: Length
- Definition:
targetSunPosition
- Type: 3-vector of double-precision floats
- Unit Type: Distance - fixed to km
- Definition:
targetHeliocentricVelocity
- Type: 3-vector of double-precision floats
- Unit Type: Distance - fixed to km/s
- Definition:
spacecraftGeocentricDistance
- Type: double-precision float
- Unit Type: Length
- Definition:
spacecraftEarthPosition
- Type: 3-vector of double-precision floats
- Unit Type: Distance - fixed to km
- Definition:
targetGeocentricDistance
- Type: double-precision float
- Unit Type: Length
- Definition:
earthTargetPosition
- Type: 3-vector of double-precision floats
- Unit Type: Length
- Definition:
earthTargetVelocity
- Type: 3-vector of double-precision floats
- Unit Type: Velocity
- Definition:
phaseAngle
- Type: Double-precision float
- Unit Type: Angle
- Definition:
celestialNorthClockAngle
- Type: Double-precision float
- Unit Type: Angle
- Definition:
solarNorthPoleClockAngle
- Type: Double-precision float
- Unit Type: Angle
- Definition: