OiDbOIFits < Jmmc/Software

%TOC%

---+ Overview

The user can upload individual OIFITS files and create a collection of their granules.

---+ Data extraction

The user provides either URL to OIFITS file hosted on a public Web server or upload files.

---+ Data mapping

Granules are extracted from OIFITS files by !OIFitsViewer and completed by data from the collection they are to be associated with.

   * each granule 

=calib_level= 2 or 3
=obs_creator_name= to current user or first author if article
=keywords= to keywords (space separated?)
=obs_collection= to new collection ID
=obs_release_date= to article publication date
=bib_reference= from the article bibcode

L3 are public

L2 with optional restriction

   * the user can add restrictions to the availability of the uploaded data (TODO)

   * all granule are public with no access limitation to the OIFITS files.



   * the granule is associated with a collection named after the catalog designation (=obs_collection=)
   * the calibration level is set the to 3 (=calib_level=)
   * the creator name (=obs_creator_name=) is set with the name of the first author from the catalog description
   * the release date (=obs_release_date=) is set to the last modification date of the catalog (last line in the catalog description)
   * the bibliographic reference (=bib_reference=) is set to the bibcode of the first paper in the catalog description

A collection have the following content:

   * a short name
   * a title
   * a description as a short text
   * dependending on the calibration level:
      * a set of user selected keywords (=calib_level= = 2)
      * an article identified by its bibcode with more data from ADS (=calib_level= = 3)

A collection must have at least a name and a title.

---+ Usage

From the !OiDB [[http://oidb.jmmc.fr][Submit new data]], the user chooses the calibration level of the data to process: L2 for calibrated data and L3 for calibrated and published data.

The form and validation rules change with the calibration level.

Calibration level 2:

   * creation of a collection is optional.
   * the collection has no associated article.
   * the user can attach a set of up to 6 keywords to the collection.
   * the user can add restriction to the availability of the uploaded data (TODO).

Calibration level 3:

   * creation of a collection is mandatory (TODO).
   * the user has to provide at least one reference to an article through its bibcode (the abstract of the article may or may not be available at ADS).
   * the keywords of the collection are taken from the keywords of the article abstract.

The user can add individual OIFITS files: 

   * the file are either downloaded from a public Web server
   * or from a local file that is uploaded to the service

Uploaded files are saved in a staging area within OiDB.

If the user requested the creation of a collection, a new XML collection document is built with the data from the upper form and uploaded to the server.

---+ Notes

The uploaded files are stored on the !OiDB server in a staging area.

The validation of target, instrument and instrument mode is not enforced.

The form for uploading individual OIFITS is very similar to the form for importing [[OiDbVizieR][VizieR catalog]].
This topic: Jmmc/Software > WebHome > OiDb > OiDbSpecs > OiDbOIFits
Topic revision: r3 - 2014-11-18 - PatrickBernaud