UnitsDesc < IVOA

<H1>IVOA DM Work Package : Units description and usage</H1>
<br/>
 %RED% !!! Work in progress : Site under re construction !!! %ENDCOLOR%                

   * lead [[IVOA.AnitaRichards][Anita Richards]] with help from [[IVOA.MireilleLouys][MireilleLouys]]
---

<H2>Goal </H2>
This workpage is meant to record the general practice in manipulating units for astronomical data and define a simple way to homogeneise their representation within VO services
<br/>
The main discussion will be initiated at the Interop meeting 2007 27 Sep (Cambridge) and recorded in the DM forum and on this page, but if necessary we will use email between a small group to thrash out details (as for Characterisation).

The material below is a starting point for discussion; I apologise if I have omitted existing efforts, please add references and/or a brief outline.  Nothing so far below is policy, just ideas for criticism/replacement.

<H2> Approach </H2>
   
How do we find out what are VO priorities?
   * What units do major data providers use?
      * Existing codings and definitions
   * What units do users want? (literature search?)
      * Need to strike a balance between being user-friendly and excessively complex models
   * Establish use cases to define the _minimum_ requirements for use of units in VO data models and applications.  
   * Produce preliminary requirements document
   * Use test implimentations
   * Check for consistency between IAU and CDS and other widely used current standards
   * Develop

<H2> Existing Documents </H2>
   * Standards
      * [[http://vizier.u-strasbg.fr/doc/catstd-3.2.htx][Standards for Astronomical Catalogues, Version 2.0]]
      * [[http://www.iau.org/Units.234.0.html][IAU Recommendations concerning Units from the IAU Style Manual by G.A. Wilkins (1989)]]
      * [[http://www.mel.nist.gov/msid/sima/07_ndml.htm][NIST (National Institute of Standards & Technology) project UnitsXML]] from IVOA.MarieLiseDubernet 
         * _note_ This looks very useful for SI and a few other units.  It is not clear if it covers astronomical units but it states that it is designed to be used alongside other namespaces.  This could be the starting point for technical developers? IVOA.AnitaRichards
      * Type `units' in many types of Linux
   * Discussion/implementation
      * [[IAUVizieRHEASARCGNU][Comparison between IAU recommendations, <nop>VizieR</nop>, HEASARC and the GNU software Units]] from IVOA.SebastienDerriere
         * _note_ This does not look too bad, as regards being possible to provide schemata for synonyms of the commonest SI and astronomical units - apart from a few degeneracies.  IVOA.AnitaRichards
      * Section 4 in Greisen and Calabretta 2002, A&A 395, 1061 - see [[http://heasarc.gsfc.nasa.gov/docs/heasarc/ofwg/docs/general/ogip_93_001/ogip_93_001.html][Specification of Physical Units within OGIP FITS files]] (not only relevant to FITS)
      * VOSpec model - described in [[http://arxiv.org/pdf/astro-ph/0511616][Dimensional Analysis applied to Spectrum Handling in VO context]] (Osuna & Salgado)
      * check <nop>SpecView</nop>...
      * [[http://hea-www.cfa.harvard.edu/~arots/nvometa/STC/STCunits.txt][Unit strings allowed in STC]] from IVOA.ArnoldRots

*Action:* Can we agree to adopt e.g. CDS units with alternatives where needed - there are relatively few instances of multiple legitimate names for the same unit (benign).  There are a very few instances of the same name for different units, is there some way to adopt the most likely default but issue a warning? Or are all such instances so obscure that they can just produce a warning for human intervention?

<H2>Existing or new tools and Libraries</H2>
---++ Where are units needed?


---+++ Construction of Spectral Energy Distributions

The use of units and interconversions has been well-developed e.g. in VOSpec and YAFIT, but consistency is due to the cooperation of the individuals involved.  A model for units would recognise this effort and allow it to be applied more widely.  

TAP - source catalogue DM - need to compare quantities

SPECFIND : A tool to extract cross-identifications and radio continuum spectra from radio catalogues contained in the VIZIER database of the CDS. <BR>
Reference:   SPECFIND Catalog of radio continuum spectra <BR>
Authors:     Vollmer, B.; Davoust, E.; Dubois, P.; Genova, F.; Ochsenbein, F.; van Driel, W. <BR>
Publication: <nop>VizieR On-line Data Catalog: VIII/74. <BR>

---+++ Cone, S?AP, registry searches

The current IVOA standards mandate units, but in some cases this repeatedly leads to problems e.g..
   * Cone search/SIAP radius - decimal degrees
      * Anomalous results are often obtained due to a service returning a region in other units (e.g. 0.1 arcmin instead of degree) (see DB queries below).
   * Spectral region - wavelength in metres
      * Conversion from frequency and energy units is non-linear.  Whilst this is trivial (and rounding errors are unimportant) for single simple regions, it makes it hard to describe  the spectral resolution with a single number, if it is e.g. 1 MHz in regions between 1 and 30 GHz.


---+++ Conversion tools
 
Need precise unit definitions

Examples include:
   * Flux unit conversions e.g.  VOSpec, tools using the STILTS library
   * Coordinate conversions (B1950 RA-Dec to J2000 glat-glon etc.)  e.g. tools using the STILTS library, SIMBAD services etc.

---+++ Database queries

We have no control over the units used by data providers (?).  We do need to be able to recognise them.  
   * Cone searches have mandated units (see below)
   * ADQL users have to know what units to use for the query parameters.  How can they check this?

Actually we can have influence - e.g. through Euro-VO DCA - at least to remind people to adhere to appropriate 'local' standard e.g. 
   * _no plurals_ W or Watt but never Watts (ambiguity with Watt second)
   * _capitalisation matters_ m(illi) v. M(ega)

---+++ Enabling convenient image display

Use case: Need a library to support displaying images with coordinates in sensible units (i.e. using SI multiple etc.) and to allow easy conversions e.g. Jy arcsec-2 to Jy sr-1 (JP Leahy).

---++ Lessons so far

---+++ Dimensional approach (see VOSpec)

Automated dimensional analysis could be an easy way to check for consistency. Request for dimensional analysis tools/library to be available.
  
---+++ Services with mandated units

Many data publishers install VO services on top of existing archives in arbitrary units.  We can't expect the astronomical users to know what that is so e.g. SIAP search areas are always supposed to be in decimal degrees, but this often comes unstuck if data are in other units. What is best:
   * Make it easy/persuade data providers forcibly to supply information in the correct units.  This would probably be feasible for data bases but near-impossible for FITS and other observed data (unless it was accessed via a database). Not all data providers would comply and either just ignor the requirement or not provide their data.
   * Find a way to insert a unit conversion tool in the query path (complicates the S?APs)
  

---+++ Conversions

It is important to define the limits of accuracy e.g.
   * Magnitude-flux - even if all observational quantities e.g. the zero-points are supplied, accuracy is limited to a few percent unless corrections like the colour of individual objects are included.
   * Positional coordinates - .epoch as well as equinox; leap seconds etc. needed for milli-arcsec accuracy.

We eventually need to be able to convert any units as accuracy as possible but often the full information is not available, so tools need to be flexible and settle for lower accuracy where unavoidable.

Models for units could include 
   * Simple formulae (but where is maths done? Limitations inside DBs)
   * Look-up tables (where?)
   * More sophisticated references to services, links with references in data etc. 





<H2>Results and Feedback </H2>
   * Comment from discussion: scope is to enable non-linear conversions (like freq-wavelength), not to include the mechanism in the Units model.  That is, we should look at the requirements of the existing tools, not duplicate them.
 

<H2>Interactions with other WG efforts</H2>
   * [[IvoaVOQL][IVOA VO Query Language]] 

---
<!--
      * Set ALLOWTOPICRENAME = %MAINWEB%.TWikiAdminGroup
-->
Attachments
Topic attachments
I	Attachment	History	Action	Size	Date	Who	Comment
txt	STCunits.txt	r1	manage	5.9 K	2007-10-05 - 16:52	ArnoldRots	Unit strings allowed in STC
txt	minutes_units_discussion_070927.txt	r1	manage	1.3 K	2007-10-01 - 06:21	AlbertoMicol	Minutes of initial discussion: Cambridge, 20070927
This topic: IVOA > WebHome > IvoaDataModel > UnitsDesc
Topic revision: r17 - 2008-05-19 - AnitaRichards