| Note: from 5 July 2021, these pages are no longer the primary source of the EPN-TAP doc - see instead the IVOA latex source: https://github.com/ivoa-std/EPNTAP |
|---|
List of EPN-TAP parameters
(refreshed/completed April 2019, Oct 2020, June 2021, Oct 2021) (SE)
You can use this file to keep track of your service parameters: EPN-TAP_parameters_List_template.xlsx
EPN-TAP
- EPN-TAP is a VO access protocol dedicated to Planetary Science data. It is based on the TAP mechanism from IVOA, completed with sets of parameters and associated lists of values. In this regard, it is similar to ObsTAP but with a different scope.
- EPN-TAP version 2 is a major update of the protocol to accommodate larger services and simplify setup and use of data services. All parameters are described here.
...
- Lab spectroscopy: parameters to describe mineralogical samples (and possibly other samples)
- Solar System objects: covers orbital/rotational parameters, physical properties, and taxonomy
- APIS: contains for consistency with APIS service. Contains parameters for observing programs Contributive works (most parameters are actually included in other extensions)
- Contributive works / observing programs: enlargement of APIS extension to other data
- Exoplanets / planetary systems properties
- Map extension (to be enlarged)
- Events: covers the VOevent standard and other types of events
- Particle spectroscopy (to be finalized)
- Results of planetary 3D modelling run (in progress)
- Bibliographic entries? May be manageable otherwise, through bibcode / doi interpretation
...
You can use this file to keep track of your service parameters: EPN-TAP_parameters_List_template.xlsx
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 TBD (from ObsCore) | |||||||
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.StopTimeTBD (from ObsCore) | |||||||
time_sampling_step_min | DoubleFloat | s | Min time sampling step | time.resolution;stat.min | time.resolution | Epn.Time.Time_sampling_step_min | |||||||
time_sampling_step_max | DoubleFloat | s | Max time sampling step | time.resolution;stat.max | Epn.Time.Time_sampling_step_max | ||||||||
time_exp_min | DoubleFloat | s | Min integration time | time.duration;obs.exposure;stat.min | time.duration;obs.exposure | Epn.Time.Time_exp_min | |||||||
time_exp_max | DoubleFloat | s | Max integration time | time.duration;obs.exposure;stat.max | Epn.Time.Time_exp_max | ||||||||
spectral_range_min | DoubleFloat | 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 | DoubleFloat | Hz | Max spectral range (as frequency) | em.freq;stat.max | em.wl;stat.max | Epn.Spectral.Spectral_range_max | |||||||
spectral_sampling_step_min | DoubleFloat | Hz | Min spectral sampling step | em.freq;spect.stepbinSize;stat.min | meta.number | Epn.Spectral.Spectral_sampling_step_min | |||||||
spectral_sampling_step_max | DoubleFloat | Hz | Max spectral sampling step | em.freq;spect.stepbinSize;stat.max | meta.number | Epn.Spectral.Spectral_sampling_step_max | |||||||
spectral_resolution_min | DoubleFloat | 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 | DoubleFloat | 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 | DoubleFloat | (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 | DoubleFloat | (1) | Max of first coordinate, depends on the frame | Epn.Spatial.Spatial_range.c1max | |||||||||
c2min | DoubleFloat | (1) | Min of second coordinate, depends on the frame. | pos.eq.dec | Epn.Spatial.Spatial_range.c2min | ||||||||
c2max | DoubleFloat | (1) | Max of second coordinate, depends on the frame | Epn.Spatial.Spatial_range.c2max | |||||||||
c3min | DoubleFloat | (1) | Min of third coordinate | Epn.Spatial.Spatial_range.c3min | |||||||||
c3max | DoubleFloat | (1) | Max of third coordinate | Epn.Spatial.Spatial_range.c3max | |||||||||
s_region | spolyText | (3) | ObsCore-like footprint in 2D (celestial or body-related framesif spatial_frame_type = celestial or body) | 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 | DoubleFloat | (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 | DoubleFloat | (2) | Max resolution in first coordinate | (2) | pos.angResolution;stat.max | Epn.Spatial.Spatial_resolution.c1_resol_max | _ | ||||||
c2_resol_min | DoubleFloat | (2) | Min resolution in second coordinate | (2) | Epn.Spatial.Spatial_resolution.c2_resol_min | _ | |||||||
c2_resol_max | DoubleFloat | (2) | Max resolution in second coordinate | (2) | Epn.Spatial.Spatial_resolution.c2_resol_max | _ | |||||||
c3_resol_min | DoubleFloat | (2) | Min resolution in third coordinate | (2) | Epn.Spatial.Spatial_resolution.c3_resol_min | pos.resolution restored in 2018 | |||||||
c3_resol_max | DoubleFloat | (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 | DoubleFloat | 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 | DoubleFloat | 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 | DoubleFloat | deg | Min emergence angle | pos.emergenceAng;stat.min | _ | Epn.View_angle.Emergence_angle_min | UCD for angles included in 2018 | ||||||
emergence_max | DoubleFloat | deg | Max emergence angle | pos.emergenceAng;stat.max | _ | Epn.View_angle.Emergence_angle_max | UCD for angles included in 2018 | ||||||
phase_min | DoubleFloat | deg | Min phase angle | pos.phaseAng;stat.min | Epn.View_angle.Phase_angle_min | ||||||||
phase_max | DoubleFloat | 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;meta.datalink | 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) | |||||||||
| wavebandmessenger | Text | Electro-magnetic 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.publisherIDbib | ||||||||
processing_level_ | referencedesc | Text | Bibcode or doi preferredDescribes specificities of the processing level | meta.note | |||||||||
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 or 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_originrefposition | 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 | Always UTC Defaults to UTC in data services - from enumerated list | time.scale | ||||||||||
| subsolar_longitude_min | DoubleFloat | 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 | DoubleFloat | 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 | DoubleFloat | deg | Minimum sub-solar point latitude | pos.bodyrc.lat;stat.min | _ | ||||||||
| subsolar_latitude_max | DoubleFloat | deg | Maximum sub-solar point latitude | pos.bodyrc.lat;stat.max | _ | ||||||||
| subobserver_longitude_min | DoubleFloat | deg | Minimum sub-observer point longitude (sub-Earth for ground based observations) | pos.bodyrc.lon;stat.min | _ | ||||||||
| subobserver_longitude_max | DoubleFloat | deg | Maximum sub-observer point longitude (sub-Earth for ground based observations) | pos.bodyrc.lon;stat.max | _ | ||||||||
| subobserver_latitude_min | DoubleFloat | deg | Minimum sub-observer point latitude (sub-Earth for ground based observations) | pos.bodyrc.lat;stat.min | _ | ||||||||
| subobserver_latitude_max | DoubleFloat | deg | Maximum sub-observer point latitude (sub-Earth for ground based observations) | pos.bodyrc.lat;stat.max | _ | ||||||||
ra | DoubleFloat | deg | Right ascension | pos.eq.ra;meta.main | deg only (like ObsCore) | ||||||||
dec | DoubleFloat | deg | Declination | pos.eq.dec;meta.main | |||||||||
| radial_distance_min | DoubleFloat | km | Min distance from observed area to body center | pos.distance;pos.bodyrc;stat.min | |||||||||
| radial_distance_max | DoubleFloat | km | Max distance from observed area to body center | pos.distance;pos.bodyrc;stat.max | |||||||||
| altitude_fromshape_min | DoubleFloat | km | Min altitude of observed area above shape model / DTM | pos.bodyrc.alt;stat.min | |||||||||
| altitude_fromshape_max | DoubleFloat | km | Max altitude of observed area above shape model / DTM | pos.bodyrc.alt;stat.max | |||||||||
solar_longitude_min | DoubleFloat | deg | Min Solar longitude Ls (location on orbit / season) | pos.ecliptic.lon;pos.heliocentric;stat.min | |||||||||
solar_longitude_max | DoubleFloat | deg | Max Solar longitude Ls (location on orbit / season) | pos.ecliptic.lon;pos.heliocentric;stat.max | |||||||||
local_time_min | DoubleFloat | h | Min local time at observed region | time.phase;time.period.rotation;time.phase;stat.min | |||||||||
local_time_max | DoubleFloat | h | Max local time at observed region | time.phase;time.period.rotation;time.phase;stat.max | |||||||||
target_distance_min | DoubleFloat | km | Min observer-target distance | pos.distance;stat.min | |||||||||
| target_distance_max | DoubleFloat | 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 | DoubleFloat | auAU | Min Earth-target distance | pos.distance;stat.min | |||||||||
| earth_distance_max | DoubleFloat | auAU | Max Earth-target distance | pos.distance;stat.max | |||||||||
| sun_distance_min | DoubleFloat | auAU | Min Sun-target distance | pos.distance;stat.min | |||||||||
| sun_distance_max | DoubleFloat | auAU | 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 | IntegerText | Proposal identifier | meta.id;obs.proposal | ||||||||||
| proposal_pi | textText | 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;metaobs.codeproposal | ||||||||||
| 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 | DoubleFloat | arcsec | Apparent radius of the target | phys.angSize;src | |||||||||
| north_pole_position | DoubleFloat | 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 | DoubleFloat | arcsec/pix | pixel angular size or platescale (on sky only) | instr.scale | |||||||||
| orientation | Float | Doubledeg | 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;meta.main | ||||||||||
| observer_id | Integer | Image observer's PVOL 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 PVOL 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 | DoubleFloat | deg | Observer's approximate longitude | obs.observer;pos.earth.lon | meta.publon in PVOL | ||||||||
| observer_lat | Float | Doubledeg | Observer's approximate latitude | obs.observer;pos.earth.lat | meta.publat in PVOL | ||||||||
| mass | DoubleFloat | kg | Mass of object | phys.mass | Solar System Objects extension (generic values in catalogues, not observations) | ||||||||
| sideralsidereal_rotation_period | DoubleFloat | h | Object rotation rate | time.period.rotation | |||||||||
| mean_radius | DoubleFloat | km | phys.size.radius | ||||||||||
| equatorial_radius | DoubleFloat | km | phys.size.radius | ||||||||||
| polar_radius | DoubleFloat | km | phys.size.radius | ||||||||||
| diameter | doubleFloat | km | Target diameter, or equivalent diameter for binary objects | phys.size.diameter | Used in tnosarecool, not very consistent (use radius?) | ||||||||
semi_major_axis | DoubleFloat | auAU | phys.size.smajAxis | ||||||||||
| inclination | DoubleFloat | deg | Orbit inclination | src.orbital.inclination | |||||||||
| eccentricity | DoubleFloat | Orbit eccentricity | src.orbital.eccentricity | ||||||||||
| long_asc | DoubleFloat | deg | Longitude of ascending node, J2000.0 | src.orbital.node | |||||||||
| arg_perihel | DoubleFloat | deg | Argument of Perihelionperihelion, J2000.0 | src.orbital.periastron | |||||||||
| mean_anomaly | DoubleFloat | deg | Mean anomaly at the epoch | src.orbital.meanAnomaly | |||||||||
| epoch | Double | d | Epoch of interest in JD | time.epoch | |||||||||
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 | DoubleFloat | 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 | DoubleFloat | mJy | Target flux | phot.flux.density | |||||||||
| albedo | DoubleFloat | 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 | DoubleFloat | pix | Map size in px | phys.size | |||||||||
| map_width | DoubleFloat | pix | Map size in px | phys.size | |||||||||
| map_scale | TextFormat TBD | Preferably a ratio (e. g., "1:50000") | pos.wcs.scale | ||||||||||
| pixelscale_min | DoubleFloat | km/pix | Min pixel size on a surface | instr.scale;stat.min | |||||||||
| pixelscale_max | DoubleFloat | km/pix | Max pixel size on a surface | instr.scale;stat.max | |||||||||
particle_spectral_type | Text | From enumerated list | meta.id;phys.particle | Particle spectroscopy extension, UCD TBD | |||||||||
particle_spectral_range_min | DoubleFloat | phys.energy;phys.particle;stat.min phys.mass;phys.particle;stat.min | |||||||||||
particle_spectral_range_max | DoubleFloat | phys.energy;phys.particle;stat.max phys.mass;phys.particle;stat.max | |||||||||||
particle_spectral_sampling_step_min | DoubleFloat | spect.resolution;phys.particle;stat.min | |||||||||||
particle_spectral_sampling_step_max | DoubleFloat | spect.resolution;phys.particle;stat.max | |||||||||||
particle_spectral_resolution_min | DoubleFloat | spect.resolution;phys.particle;stat.min | |||||||||||
particle_spectral_resolution_max | DoubleFloat | 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;meta.main | Experimental spectroscopy + contributive work extensions | |||||||||
producer_name | Text | Data producer name, especially in compilations of experimental data | meta.note;meta.main | ||||||||||
producer_institute | Text | Data producer institute, e. g., in compilations of experimental data | meta.note;meta.main | ||||||||||
| 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 | ||||||||||
| data_calibration_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 | DoubleFloat | um | Min sample particle size | phys.size;stat.min | |||||||||
| grain_size_max | DoubleFloat | um | Max sample particle size | phys.size;stat.max | |||||||||
| azimuth_min | DoubleFloat | deg | Min azimuth angle for illumination | pos.azimuth;stat.min | Check meaning/requirements for <0 values? | ||||||||
| azimuth_max | DoubleFloat | deg | Max azimuth angle for illumination | pos.azimuth;stat.max | UCD added in 2018 | ||||||||
pressure | DoubleFloat | bar | Ambient pressure | phys.pressure | VOunits says: Pascal. But this is in files | ||||||||
measurement_atmosphere | textText | Describes experimental conditions. "vacuum" for measurements under vacuum. | meta.note;phys.pressure | ||||||||||
| temperature | DoubleFloat | K | Ambient temperature | phys.temperature | |||||||||
event_type | Text | Type of event from enumerated list | TBD meta.code.class | Events extension | |||||||||
| event_status | Text | From enumerated list TBD | meta.code.status | ||||||||||
| event_cite | Text | From enumerated list TBD | meta.code.status |
(1): depending on context (as given by spatial_frame_type), see table below
...
(2) Spatial resolution parameters have the same unit as spatial coordinate parameters. The associated UCD combine either pos.resolution (if linear) or pos.angResolution (if angular) with secondary stat.min or stat.max
c1: only body and celestial are angular; c2: only cartesian is linear; c3: only spherical is angular
(3): Any contour type that works with ADQL's geometry operators (CONTAINS, INTERSECTS...) is legal here
(4): Timestamps are provided as ISO-8601 String
...
String as specified by DALI. On VOtable output, xtype="timestamp" attribute is required.
| Frame coordinates UCD/units | celestial | body | cartesian | spherical | cylindrical |
|---|
c1min | pos.eq.ra;stat.min | pos.bodyrc.lon;stat.min | pos.cartesian.x;stat.min (in km) | pos.spherical. |
|---|
r;stat. |
min ( |
in m) |
pos.cylindrical. |
r;stat. |
min (in km) | |
| c1max | pos.eq. |
|---|
| ra;stat. |
| max |
| pos. |
| bodyrc.lon;stat. |
| max | pos. |
cartesian. |
x;stat.max (in km) | pos. |
spherical. |
r;stat. |
max (in m) | pos. |
cylindrical. |
r;stat. |
max (in km) | ||||
| c2min | pos.eq.dec;stat.min | pos.bodyrc.lat;stat.min | pos.cartesian.y;stat.min (in km) | pos. |
|---|
or pos.az.zd
spherical.colat;stat.min |
pos. |
cylindrical.azi;stat.min | ||||
| c2max | pos.eq.dec;stat.max | pos.bodyrc.lat;stat.max | pos.cartesian.y;stat.max (in km) | pos. |
|---|
or pos.az.zd
spherical.colat;stat.max |
pos. |
cylindrical.azi;stat.max | |
| c3min | pos.distance;stat.min (in |
|---|
AU) | pos.bodyrc.alt;stat.min (from surface only, implicitly from reference level) (in km) | pos.cartesian.z;stat.min (in km) | pos. |
or pos.az.
spherical.azi;stat.min |
pos.cylindrical. |
z;stat.min (height |
, in km) | |
| c3max | pos.distance;stat.max (in |
|---|
AU) | pos.bodyrc.alt;stat.max (from surface only, implicitly from reference level) (in km) | pos.cartesian.z;stat.max (in km) | pos. |
or pos.az.
spherical.azi;stat.max |
pos.cylindrical. |
z;stat.max (height |
, in km) |
Example table for IDs:
File name-type | granule_uid | granule_gid | obs_id |
A-Raw | 1 | native | A |
A-Calib | 2 | calibrated | A |
A-geom | 3 | geometry | A |
A-proj | 4 | projected | A |
B-Raw | 5 | native | B |
B-Calib | 6 | calibrated | B |
B-geom | 7 | geometry | B |
B-proj | 8 | projected | B |
...
• Granule_gid: any general indication to providers? I.e.: preview, native, calibrated, geometry…
A client should be able to display the values present in a service, TBC service (feasible in TOPCAT)
• Reshuffle previous "service parameters":
- Mandatory :
publisher - make it mandatory???
add publisher_did as in Obscore? (for DaCHS/registry; provides unique ID of service for this publisher/server), with UCD = meta.ref.uri;meta.curation - Optional - TBCOptional
spatial_coordinate_description (default = none)
spatial_origin (default = body center or SS barycenter? Or observer location)
time_origin (default = observer)
time_scale (default = UTC – no other values allowed in data services? [only in computational services, e.g. ephemeris])
Same values to be used in registry declaration
...
Accref is introduced by the EPN-TAP localfile mixin, but not used - in principle not included in TAP response, be may be present anyway. It may be better to hide it entirely also in the portal (TBC).
• Parameters introducing error bars/uncertainties
...
Solution with datalink seems OK: data files under access_url and detached labels provided under datalink_url in a link table - although no attempt made to read them from the portal yet (use VIR unpublished service to test this).
• Utypes (TBC)
Need to clean up current doc (2.0). Utypes are = DM fields. They are supposedly used to identify the meaning of parameters and help e.g. tools to grab required quantities - This will not work in some areas though, e. g. with spectral tools as they currently use UCD instead of Utype for this purpose (not many tools appear to actually rely on Utype in fact). See discussion here for usage (a bit old?): http://www.ivoa.net/documents/Notes/UTypesUsage/20130213/NOTE-utypes-usage-1.0-20130213.html
...