Overview

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

It is possible to upload either calibrated data (L2) or calibrated and published data (L3). In the first case the user can specify optional access restrictions. Otherwise the data is considered public and access to the associated OIFITS file is authorized.

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.

Calibration level 2:

• the calibration level (calib_level) is set to 2.
• the collection ID is set to the ID the collection from the upper part of the form if any.
• the dataPI (datapi) is set the current user (L2, calibrated data).
• the associated keywords is semi-colon-separated list of keyword given by the user (L2, calibrated data) to the collection.
• the bibliographic reference (bib_reference) is empty.
• the access (data_rights) is public or secure (TODO).
• the release date (obs_release_date) is the current date (L2, calibrated data) (TODO).

Calibration level 3:

• the calibration level (calib_level) is set to 3.
• the collection ID is set to the ID the collection from the upper part of the form.
• the dataPI (datapi) is set to the first author of the first article registered with the collection.
• the associated keywords is semi-colon-separated list of keywords from the first article registered with the collection.
• the bibliographic reference (bib_reference) is the bibcode of the first article.
• the access (data_rights) is public
• the release date (obs_release_date) is the publication date of the first article.

A collection have the following content:

• a short name (required)
• a title (required)
• a description as a short text
• dependending on the calibration level:
  • a possibly empty set of user selected keywords (calibrated data, L2)
  • an article identified by its bibcode with more data from ADS (published data, L3)

Usage

From the OiDB 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 (oidb-data/oifits/staging/).

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 VizieR catalogs.