Note: from 5 July 2021, these pages are no longer the source of the EPN-TAP doc - see IVOA instead for the latex source: https://github.com/ivoa-std/EPNTAP |
---|
List of EPN-TAP parameters
(refreshed/completed April 2019, Oct 2020, June 2021) (SE)
...
Name | SQL type | Unit | Description | UCD | UCD in Obscore 1.1 (9/5/2017 REC version) | Utype (tentative) | Comments | ||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
EPNCore mandatory parameters | Current value | — ? : closest sense _ : N/A in ObsCore | from epntap v2 mixin (aug 2017) | ||||||||||
granule_uid | Text | Unique ID in data service | meta.id | meta.id | Can be alphanum. | ||||||||
granule_gid | Text | Common to granules of same type | meta.id | meta.id | E.g. same map projection, or geometry data products. Can be alphanum. | ||||||||
obs_id | Text | Associates granules derived from the same data | meta.id;obs | meta.id | obscore:DataID.observationID | E.g. various representations / processing levels. Can be alphanum., may be the ID of original observation. Keep it simple in intricate situations. | |||||||
dataproduct_type | Text | Organization of the data product, from enumerated list | meta.code.class | meta.id | Epn.dataProductType obscore:ObsDataset.dataProductType | ||||||||
target_name | Text | Standard IAU name of target (must match target_class), case sensitive | meta.id;src | meta.id;src | Epn.TargetName | Case sensitive Services with no target_name do exist | |||||||
target_class | Text | Type of target, from enumerated list | src.class | src.class | Epn.TargetClass | ||||||||
time_min | Double | d | Start time (in JD). UTC measured at time_origin location (default is observer's frame) | time.start;obs | time.start;obs.exposure | Char.TimeAxis.Coverage.Bounds.Limits.Interval.StartTime | |||||||
time_max | Double | d | Stop time (in JD). UTC measured at time_origin location (default is observer's frame) | time.end;obs | time.end;obs.exposure | Char.TimeAxis.Coverage.Bounds.Limits.Interval.StopTime | |||||||
time_sampling_step_min | Float | s | Min time sampling step | time.resolution;stat.min | time.resolution | Epn.Time.Time_sampling_step_min | |||||||
time_sampling_step_max | Float | s | Max time sampling step | time.resolution;stat.max | Epn.Time.Time_sampling_step_max | ||||||||
time_exp_min | Float | s | Min integration time | time.duration;obs.exposure;stat.min | time.duration;obs.exposure | Epn.Time.Time_exp_min | |||||||
time_exp_max | Float | s | Max integration time | time.duration;obs.exposure;stat.max | Epn.Time.Time_exp_max | ||||||||
spectral_range_min | Float | Hz | Min spectral range (as frequency) | em.freq;stat.min | em.wl;stat.min (always as wl) | Epn.Spectral.Spectral_range_min | Always as frequency | ||||||
spectral_range_max | Float | Hz | Max spectral range (as frequency) | em.freq;stat.max | em.wl;stat.max | Epn.Spectral.Spectral_range_max | |||||||
spectral_sampling_step_min | Float | Hz | Min spectral sampling step | em.freq;stat.interval;stat.min | meta.number | Epn.Spectral.Spectral_sampling_step_min | |||||||
spectral_sampling_step_max | Float | Hz | Max spectral sampling step | em.freq;stat.interval;stat.max | meta.number | Epn.Spectral.Spectral_sampling_step_max | |||||||
spectral_resolution_min | Float | Min spectral resolution (resolving power) | spect.resolution;stat.min | spect.resolution (relates to resolving power) | Epn.Spectral.Spectral_resolution_min | Now (2019) provides resolving power |(lambda / delta(lambda)| = |f /Df| | |||||||
spectral_resolution_max | Float | Max spectral resolution (resolving power) | spect.resolution;stat.max | Epn.Spectral.Spectral_resolution_max | Now (2019) provides resolving power |(lambda / delta(lambda)| = |f /Df| | ||||||||
c1min | Float | (1) | Min of first coordinate, depends on the frame | see table below | pos.eq.ra | Epn.Spatial.Spatial_range.c1min | Typo in current mixin (.lonG => .lon UCDs for cyl and sph coord are from PEN-UCDlist-20210430 | ||||||
c1max | Float | (1) | Max of first coordinate, depends on the frame | Epn.Spatial.Spatial_range.c1max | |||||||||
c2min | Float | (1) | Min of second coordinate, depends on the frame. | pos.eq.dec | Epn.Spatial.Spatial_range.c2min | ||||||||
c2max | Float | (1) | Max of second coordinate, depends on the frame | Epn.Spatial.Spatial_range.c2max | |||||||||
c3min | Float | (1) | Min of third coordinate | Epn.Spatial.Spatial_range.c3min | |||||||||
c3max | Float | (1) | Max of third coordinate | Epn.Spatial.Spatial_range.c3max | |||||||||
s_region | spoly | (3) | ObsCore-like footprint in 2D (celestial or body-related frames) | pos.outline;obs.field | pos.outline;obs.field | obscore:Char.SpatialAxis.Coverage.Support.Area | (was initially instr.fov, to be corrected) Must have xtype= adql:REGION to work with TAP | ||||||
c1_resol_min | Float | (2) | Min resolution in first coordinate | (2) | pos.angResolution;stat.min | Epn.Spatial.Spatial_resolution.c1_resol_min | pos.resolution restored in 2018 In body fixed frame, use pixelscale_min/max for resolution at the surface | ||||||
c1_resol_max | Float | (2) | Max resolution in first coordinate | (2) | pos.angResolution;stat.max | Epn.Spatial.Spatial_resolution.c1_resol_max | _ | ||||||
c2_resol_min | Float | (2) | Min resolution in second coordinate | (2) | Epn.Spatial.Spatial_resolution.c2_resol_min | _ | |||||||
c2_resol_max | Float | (2) | Max resolution in second coordinate | (2) | Epn.Spatial.Spatial_resolution.c2_resol_max | _ | |||||||
c3_resol_min | Float | (2) | Min resolution in third coordinate | (2) | Epn.Spatial.Spatial_resolution.c3_resol_min | pos.resolution restored in 2018 | |||||||
c3_resol_max | Float | (2) | Max resolution in third coordinate | (2) | Epn.Spatial.Spatial_resolution.c3_resol_max | pos.resolution restored in 2018 | |||||||
spatial_frame_type | Text | (1) | Flavor of coordinate system, defines the nature of coordinates. From enumerated list. Use "none" if undefined | meta.code.class;pos.frame | _ | A value is required by DaCHS (query will return errors if empty) | |||||||
incidence_min | Float | deg | Min incidence angle (solar zenithal angle) | pos.incidenceAng;stat.min | _ | Epn.View_angle.Incidence_angle_min | UCD for angles included in 2018 | ||||||
incidence_max | Float | deg | Max incidence angle (solar zenithal angle) | pos.incidenceAng;stat.max | _ | Epn.View_angle.Incidence_angle_max | UCD for angles included in 2018 | ||||||
emergence_min | Float | deg | Min emergence angle | pos.emergenceAng;stat.min | _ | Epn.View_angle.Emergence_angle_min | UCD for angles included in 2018 | ||||||
emergence_max | Float | deg | Max emergence angle | pos.emergenceAng;stat.max | _ | Epn.View_angle.Emergence_angle_max | UCD for angles included in 2018 | ||||||
phase_min | Float | deg | Min phase angle | pos.phaseAng;stat.min | Epn.View_angle.Phase_angle_min | ||||||||
phase_max | Float | deg | Max phase angle | pos.phaseAng;stat.max | Epn.View_angle.Phase_angle_max | ||||||||
instrument_host_name | Text | Standard name of the observatory or spacecraft | meta.id;instr.obsty | meta.id;instr.tel | Provenance.ObsConfig.Facility.name | ||||||||
instrument_name | Text | Standard name of instrument | meta.id;instr | meta.id;instr | Provenance.ObsConfig.Instrument.name | ||||||||
measurement_type | Text | UCD(s) defining the data | meta.ucd | meta.ucd | Epn.Measurement_type | Add ;meta.modelled if simulation or model Add ;stat.uncalib if uncalibrated data - in which case processing_level must be 0 or 1 | |||||||
processing_level | Integer | Dataset-related encoding, or simplified CODMAC calibration level | meta.calibLevel | meta.code;obs.calib | ~ obscore:ObsDataset.calibLevel | To be replaced by PDS4 values in v2.1? | |||||||
creation_date | Timestamp | (4) | Date of first entry of this granule | time.creation | time;meta.dataset | ||||||||
modification_date | Timestamp | (4) | Date of last modification | time.processing | Used to handle mirroring | ||||||||
release_date | Timestamp | (4) | Start of public access period (set to creation_date if no proprietary period) | time.release | time.release | obscore:Curation.releaseDate | The value is in ISO 8601 format reusing this pattern: (“YYYY-MM-DDThh:mm:ss”) If release_date is in the future, the data is proprietary. | ||||||
service_title | Text | Title of resource = schema name | meta.title | May be used to handle multiservice results | |||||||||
Common optional parameters | |||||||||||||
access_url | Text | URL of the data file, case sensitive (additional files may be linked through datalink_url). Can point to a script. If present, next 2 parameters must also be present | meta.ref.url;meta.file | meta.ref.url | Obs.Access.Reference | Use this to link data! | |||||||
access_format | Text | RFC 2045 media type (mime), required to be all-lower case | meta.code.mime | meta.code.mime | Obs.Access.Format | ||||||||
access_estsize | Integer | kbyte | Estimate file size in kbyte (with this spelling) | phys.size;meta.file | phys.size;meta.file | Obs.Access.Size | |||||||
access_md5 | Text | MD5 Hash for the file when available (real file, not script) | meta.checksum;meta.file | ||||||||||
thumbnail_url | Text | URL of a thumbnail image with predefined size (png ~200 pix, for use in a client only) | meta.ref.url;meta.preview | ||||||||||
file_name | Text | Name of the data file only, case sensitive | meta.id;meta.file | meta.title;obs — ? | ObsCore obs_title is for a short free text string describing the granule. Do we want this? | ||||||||
datalink_url | Text | Provides links to files or services on the server | meta.ref.url | Associated mime-type is 'application/x-votable+xml;content=datalink' (from ObsCore) | |||||||||
species | Text | Identifies a chemical species, case sensitive | meta.id;phys.atmol | This is the only case sensitive parameter (with target_name) | |||||||||
messenger | Text | Vector of measured signal, including electromagnetic | instr.bandpass | ||||||||||
alt_target_name | Text | Provides alternative target name(s). Can be a hash list | meta.id;src | ||||||||||
target_region | Text | Type of region or feature of interest | meta.id;src;obs.field | ||||||||||
feature_name | Text | Secondary name (e.g. standard name of a region of interest) | meta.id;src;obs.field |
| |||||||||
publisher | Text | Resource publisher | meta.curation | meta.ref.uri;meta.curation | ~ obscore:Curation.publisherID | ||||||||
bib_reference | Text | Bibcode or doi preferred; can be a URL or anything else. Refers to the granule | meta.bib | meta.bib | obscore:Curation.reference | Bibcode & doi can be completed in TOPCAT | |||||||
internal_reference | Text | Related granule_uid(s) in the current service | meta.id.cross | Use to link one granule to a set of other granules. To be used only if required - e.g. to solve situations that would otherwise require several tables | |||||||||
external_link | Text | Web page providing more details on the granule | meta.ref.url | Link to an individual page in a web site associated to the database, e.g., a planet page in Exoplanets service. This is a way to provide extra granule information which cannot be accommodated in the table. | |||||||||
shape | Text | introduces an ascii (ST)MOC, v2 (2D footprint on celestial, spherical, or body-related frames, possibly including time) | pos.outline;obs.field | Must have xtype="MOC" (follow DALI recommendation) outline doesn't fit definition (refers to a contour) | |||||||||
spatial_coordinate_description | Text | ID of specific coordinate system and version / properties | meta.code.class;pos.frame | ~COOSYS, but includes planetary ones | |||||||||
spatial_origin | Text | Defines the frame origin | meta.ref;pos.frame | ||||||||||
time_refposition | Text | Defines where the time is measured (e. g., ground vs spacecraft). Default is observer's frame | meta.ref;time.scale | target_time is of course always on target. | |||||||||
time_scale | Text | Defaults to UTC in data services - from enumerated list | time.scale | ||||||||||
subsolar_longitude_min | Float | deg | Minimum sub-solar point longitude | pos.bodyrc.lon;stat.min | Provided in the most natural body-related coordinate frame, E-handed - seems to require 'body' | ||||||||
subsolar_longitude_max | Float | deg | Maximum sub-solar point longitude | pos.bodyrc.lon;stat.max | Provided in the most natural body-related coordinate frame, E-handed - seems to require 'body' | ||||||||
subsolar_latitude_min | Float | deg | Minimum sub-solar point latitude | pos.bodyrc.lat;stat.min | _ | ||||||||
subsolar_latitude_max | Float | deg | Maximum sub-solar point latitude | pos.bodyrc.lat;stat.max | _ | ||||||||
subobserver_longitude_min | Float | deg | Minimum sub-observer point longitude (sub-Earth for ground based observations) | pos.bodyrc.lon;stat.min | _ | ||||||||
subobserver_longitude_max | Float | deg | Maximum sub-observer point longitude (sub-Earth for ground based observations) | pos.bodyrc.lon;stat.max | _ | ||||||||
subobserver_latitude_min | Float | deg | Minimum sub-observer point latitude (sub-Earth for ground based observations) | pos.bodyrc.lat;stat.min | _ | ||||||||
subobserver_latitude_max | Float | deg | Maximum sub-observer point latitude (sub-Earth for ground based observations) | pos.bodyrc.lat;stat.max | _ | ||||||||
ra | Float | deg | Right ascension | pos.eq.ra;meta.main | deg only (like ObsCore) | ||||||||
dec | Float | deg | Declination | pos.eq.dec;meta.main | |||||||||
radial_distance_min | Float | km | Min distance from observed area to body center | pos.distance;pos.bodyrc;stat.min | |||||||||
radial_distance_max | Float | km | Max distance from observed area to body center | pos.distance;pos.bodyrc;stat.max | |||||||||
altitude_fromshape_min | Float | km | Min altitude of observed area above shape model / DTM | pos.bodyrc.alt;stat.min | |||||||||
altitude_fromshape_max | Float | km | Max altitude of observed area above shape model / DTM | pos.bodyrc.alt;stat.max | |||||||||
solar_longitude_min | Float | deg | Min Solar longitude Ls (location on orbit / season) | pos.ecliptic.lon;pos.heliocentric;stat.min | |||||||||
solar_longitude_max | Float | deg | Max Solar longitude Ls (location on orbit / season) | pos.ecliptic.lon;pos.heliocentric;stat.max | |||||||||
local_time_min | Float | h | Min local time at observed region | time.phase;time.period.rotation;stat.min | |||||||||
local_time_max | Float | h | Max local time at observed region | time.phase;time.period.rotation;stat.max | |||||||||
target_distance_min | Float | km | Min observer-target distance | pos.distance;stat.min | |||||||||
target_distance_max | Float | km | Max observer-target distance | pos.distance;stat.max | |||||||||
target_time_min | Timestamp | (4) | Min observing time in target frame | time.start;src | (simplest way to look for coordinated observations) | ||||||||
target_time_max | Timestamp | (4) | Max observing time in target frame | time.end;src | |||||||||
earth_distance_min | Float | AU | Min Earth-target distance | pos.distance;stat.min | |||||||||
earth_distance_max | Float | AU | Max Earth-target distance | pos.distance;stat.max | |||||||||
sun_distance_min | Float | AU | Min Sun-target distance | pos.distance;stat.min | |||||||||
sun_distance_max | Float | AU | Max Sun-target distance | pos.distance;stat.max | |||||||||
Parameters from extensions | |||||||||||||
obs_mode | Text | Observing mode | meta.code;instr.setup | From APIS + observation extensions (with adapted UCDs) | |||||||||
detector_name | Text | Detector name | meta.id;instr.det | ||||||||||
opt_elem | Text | Optical element name | meta.id;instr.param | ||||||||||
filter | Text | Identifies filter in use, typically for images | meta.id;instr.filter | Informative only, free format (no list, but see http://svo2.cab.inta-csic.es/svo/theory/fps3/). Search can only rely on spectral range, as ObsCore does. | |||||||||
instrument_type | Text | type of instrument | meta.id;instr | Informative only (not a reliable search parameter): free format, no reference list intended. | |||||||||
acquisition_id | Text | ID of the data file/acquisition in the original archive | meta.id | ||||||||||
proposal_id | Text | Proposal identifier | meta.id;obs.proposal | ||||||||||
proposal_pi | Text | Proposal principal investigator | meta.id.PI;obs.proposal | ||||||||||
proposal_title | Text | Proposal title | meta.title;obs.proposal | ||||||||||
campaign | Text | Name of the observational campaign | meta.id;obs.proposal | ||||||||||
target_description | Text | Original target keywords | meta.note;src | ||||||||||
proposal_target_name | Text | target name as in proposal title | meta.note;obs.proposal | ||||||||||
target_apparent_radius | Float | arcsec | Apparent radius of the target | phys.angSize;src | |||||||||
north_pole_position | Float | deg | North pole position angle with respect to celestial north pole | pos.posAng | Group of 5 parameters very specific to APIS. Name is ~ OK, but actually provides the position angle of the planet axis. Use "orientation" for the image. | ||||||||
target_primary_hemisphere | Text | Primary observed hemisphere | meta.id;obs.field | ||||||||||
target_secondary_hemisphere | Text | Secondary observed hemisphere | meta.id;obs.field | ||||||||||
platesc | Float | arcsec/pix | pixel angular size or platescale (on sky only) | instr.scale | |||||||||
orientation | Float | deg | Position angle of image y axis (on sky only) | pos.posAng | Provides the direction of the polar axis in the image, counted clockwise from north. | ||||||||
observer_name | Text | Observer name | obs.observer;meta.main | ||||||||||
observer_institute | Text | Observer institute | meta.note | ||||||||||
observer_id | Integer | Image observer's numeric identifier | meta.id.PI | Group of 5 from PVOL, OK for general use but UCDs have to be changed in PVOL. | |||||||||
observer_code | Text | Image observer's service username | meta.id.PI | meta.pubcode in PVOL | |||||||||
observer_country | Text | Image observer's country of residence | meta.note;obs.observer | meta.pubcountry in PVOL | |||||||||
observer_lon | Float | deg | Observer's approximate longitude | obs.observer;pos.earth.lon | meta.publon in PVOL | ||||||||
observer_lat | Float | deg | Observer's approximate latitude | obs.observer;pos.earth.lat | meta.publat in PVOL | ||||||||
mass | Float | kg | Mass of object | phys.mass | Solar System Objects extension (generic values in catalogues, not observations) | ||||||||
sidereal_rotation_period | Float | h | Object rotation rate | time.period.rotation | |||||||||
mean_radius | Float | km | phys.size.radius | ||||||||||
equatorial_radius | Float | km | phys.size.radius | ||||||||||
polar_radius | Float | km | phys.size.radius | ||||||||||
diameter | Float | km | Target diameter, or equivalent diameter for binary objects | phys.size.diameter | Used in tnosarecool, not very consistent (use radius?) | ||||||||
semi_major_axis | Float | AU | phys.size.smajAxis | ||||||||||
inclination | Float | Orbit inclination | src.orbital.inclination | ||||||||||
eccentricity | Float | Orbit eccentricity | src.orbital.eccentricity | ||||||||||
long_asc | Float | deg | Longitude of ascending node, J2000.0 | src.orbital.node | |||||||||
arg_perihel | Float | deg | Argument of Perihelion, J2000.0 | src.orbital.periastron | |||||||||
mean_anomaly | Float | deg | Mean anomaly at the epoch | src.orbital.meanAnomaly | |||||||||
dynamical_class | Text | Class of small body, from enumerated list | meta.code.class;src | ||||||||||
dynamical_type | Text | Subdivision of the class, from enumerated list | meta.code.class;src | ||||||||||
taxonomy_code | Text | Code for target taxonomy | src.class.color | Possible values depend on target type and possibly on service | |||||||||
magnitude | Float | mag | Absolute magnitude. For small bodies, from HG magnitude system | phys.magAbs | Actually depends on service (eg, spectro_planets vs DynAstVO vs tnosarecool). UCD may include mention of the photometric band. | ||||||||
flux | Float | mJy | Target flux | phot.flux.density | |||||||||
albedo | Float | Target albedo | phys.albedo | ||||||||||
map_projection | Text | ID from enumerated list, or string with parameters (referring to a standard) | pos.projection | Map extension | |||||||||
map_height | Float | pix | Map size in px | phys.size | |||||||||
map_width | Float | pix | Map size in px | phys.size | |||||||||
map_scale | Text | Format TBD | pos.wcs.scale | ||||||||||
pixelscale_min | Float | km/pix | Min pixel size on a surface | instr.scale;stat.min | |||||||||
pixelscale_max | Float | km/pix | Max pixel size on a surface | instr.scale;stat.max | |||||||||
particle_spectral_type | Text | From enumerated list | meta.id;phys.particle | ||||||||||
particle_spectral_range_min | Float | phys.energy;phys.particle;stat.min phys.mass;phys.particle;stat.min | |||||||||||
particle_spectral_range_max | Float | phys.energy;phys.particle;stat.max phys.mass;phys.particle;stat.max | |||||||||||
particle_spectral_sampling_step_min | Float | spect.resolution;phys.particle;stat.min | |||||||||||
particle_spectral_sampling_step_max | Float | spect.resolution;phys.particle;stat.max | |||||||||||
particle_spectral_resolution_min | Float | spect.resolution;phys.particle;stat.min | |||||||||||
particle_spectral_resolution_max | Float | spect.resolution;phys.particle;stat.max | |||||||||||
original_publisher | Text | Refers to the source of the data, e. g., in compilations of experimental data | meta.note | Experimental spectroscopy + contributive work extensions | |||||||||
producer_name | Text | Data producer name, especially in compilations of experimental data | meta.note | ||||||||||
producer_institute | Text | Data producer institute, e. g., in compilations of experimental data | meta.note | ||||||||||
sample_id | Text | Provides a local ID in an existing catalogue | meta.id;src | In addition to target_name | |||||||||
sample_classification | Text | Information related to class, sub-class, species… as hash list | meta.note;phys.composition | This uses standard names for classes… | |||||||||
sample_desc | Text | Describes the sample, its origin, and possible preparation. Can be a hash list | meta.note | ||||||||||
species_inchikey | Text | Fixed length string identifying the species. Can be a hash list | meta.id;phys.atmol | Follows IUPAC standard (Heller et al 2015) | |||||||||
data_calibration_desc | Text | Provides information on post-processing. Can be a hash list | meta.note | (preferably to a "comment" parameter) | |||||||||
setup_desc | Text | Describes the experimental setup. Can be a hash list | meta.note | May include Aperture (size of sample measured), etc | |||||||||
geometry_type | Text | Type of observation, from enumerated list. Can be a hash list | meta.note;instr.setup | ||||||||||
spectrum_type | Text | Type of spectral observation, from enumerated list TBD. Can be a hash list | meta.note;instr.setup | Alternative to UCD, very detailed | |||||||||
grain_size_min | Float | um | Min sample particle size | phys.size;stat.min | |||||||||
grain_size_max | Float | um | Max sample particle size | phys.size;stat.max | |||||||||
azimuth_min | Float | deg | Min azimuth angle for illumination | pos.azimuth;stat.min | Check meaning/requirements for <0 values? | ||||||||
azimuth_max | Float | deg | Max azimuth angle for illumination | pos.azimuth;stat.max | UCD added in 2018 | ||||||||
pressure | Float | bar | Ambient pressure | phys.pressure | VOunits says: Pascal. | ||||||||
measurement_atmosphere | Text | Describes experimental conditions. "vacuum" for measurements under vacuum | meta.note;phys.pressure | ||||||||||
temperature | Float | K | Ambient temperature | phys.temperature | |||||||||
event_type | Text | Type of event from enumerated list | meta.code.class | Events extension | |||||||||
event_status | Text | From enumerated list | meta.code.status | ||||||||||
event_cite | Text | From enumerated list | meta.code.status |
...