.. index::
    pair: V.3.01; Release Notes

******************************
  EBAS 3.01 Release Notes
******************************

:Author: PE/ATMOS <pe@nilu.no>

.. seealso::

   :doc:`index`

Special Note
============

V.3.01 introduces a number of *big features* requiring fundamental additions
and changes in the :ref:`data model <EbasDatamodel>` and thus changes throughout
all software layers.

Features
========

* All ebas commandline programs: selection criteria :option:`--component` now
  works with :term:`strict synonyms <Component synonym>` (special behavior for
  :term:`lookup names <Lookup Name>`)

  | Issue Description: `EWB-391 <http://jira.nilu.no/browse/EWB-391>`_
  | Fix: svn r1948

* :ref:`EBASprogram_ebas_insert`: Perform selected checks earlier in the process
  in order to improve the comprehensibility. Additionally, those checks are now
  performed by file checkers without full database access
  (e.g. EBAS Submission Tool)

  | Issue Description: `EWB-290 <http://jira.nilu.no/browse/EWB-290>`_
  | Fix: svn r1948

* :ref:`Data Model <EbasDatamodel>`:
  new
  :ref:`Analytical instrument metadata <EbasDatamodelAnaInstMetadata>`

  | Issue Description: `EWB-377 <http://jira.nilu.no/browse/EWB-377>`_
  | Fix: svn r1948

* :ref:`Data Model <EbasDatamodel>`:
  new
  :ref:`QA Metadata <EbasDatamodelQAMetadata>`

  | Issue Description: `EWB-406 <http://jira.nilu.no/browse/EWB-406>`_
  | Fix: svn r1948

* :ref:`Data Model <EbasDatamodel>`:
  new
  :term:`Component synonyms <Component synonym>`

  | Issue Description: `EWB-509 <http://jira.nilu.no/browse/EWB-509>`_
  | Fix: svn r1948

* :ref:`Data Model <EbasDatamodel>`:
  new
  :ref:`Secondary standard ID <EbasDatasetTimeDependentDatasetMetadata>`

  | Issue Description: `EWB-410 <http://jira.nilu.no/browse/EWB-410>`_
  | Fix: svn r1948

* :ref:`Data Model <EbasDatamodel>`:
  new
  :ref:`Inlet specific metadata, zero/span check metadata <EbasDatasetTimeDependentDatasetMetadata>`

  | Issue Description: `EWB-395 <http://jira.nilu.no/browse/EWB-395>`_
  | Fix: svn r1948

* :ref:`Data Model <EbasDatamodel>`:
  new
  :ref:`Filter specific metadata <EbasDatasetTimeDependentDatasetMetadata>`

  | Issue Description: `EWB-434 <http://jira.nilu.no/browse/EWB-434>`_
  | Fix: svn r1948

* :ref:`Data Model <EbasDatamodel>`:
  new metadata
  :ref:`Absorption cross section <EbasDatasetAdditionalMetadata>` and
  :ref:`Maintenance description <EbasDatasetTimeDependentDatasetMetadata>`

  | Issue Description: `EWB-433 <http://jira.nilu.no/browse/EWB-433>`_
  | Fix: svn r1948

* :ref:`Data Model <EbasDatamodel>`:
  new metadata
  :ref:`Upper range limit <EbasDatasetTimeDependentDatasetMetadata>`

  | Issue Description: `EWB-463 <http://jira.nilu.no/browse/EWB-463>`_
  | Fix: svn r1948

* :ref:`Data Model <EbasDatamodel>`:
  new metadata
  :ref:`Ozone correction and Water vapor correction <EbasDatasetTimeDependentDatasetMetadata>`

  | Issue Description: `EWB-472 <http://jira.nilu.no/browse/EWB-472>`_
  | Fix: svn r1948

* :ref:`Data Model <EbasDatamodel>`:
  new metadata
  :ref:`Sensor type <EbasDatasetAdditionalMetadata>`

  | Issue Description: `EWB-446 <http://jira.nilu.no/browse/EWB-446>`_
  | Fix: svn r1948

* :ref:`Data Model <EbasDatamodel>`:
  Parameters / instrument type combinations are now controlled. A new combination
  must be allowed in order to prevent errors in incoming files to make it into
  the database.

  | Issue Description: `EWB-438 <http://jira.nilu.no/browse/EWB-438>`_
  | Fix: svn r1948

* :ref:`Data Model <EbasDatamodel>`:
  add CF unit to the :term:`parameter` masterdata.

  | Issue Description: `EWB-456 <http://jira.nilu.no/browse/EWB-456>`_
  | Fix: svn r1948


* :ref:`Data Model <EbasDatamodel>`:
  add :ref:`ORCID <http://orcid.org>` identifier to
  :ref:`person metadata <EbasDatamodelRoles>`.
  Amend syntax of :term:`data originator` and :term:`data submitter` in the
  EBAS Nasa Ames file format.

  | Issue Description: `EWB-457 <http://jira.nilu.no/browse/EWB-457>`_
  | Fix: svn r1948

* :ref:`Data Model <EbasDatamodel>`:
  add responsible person (within the datacenter) to framework masterdata.

  | Issue Description: `EWB-412 <http://jira.nilu.no/browse/EWB-412>`_
  | Fix: svn r1948

* :ref:`Data Model <EbasDatamodel>`:
  add :ref:`EbasDatamodelDatasetCharacteristics` *Gust definition*

  | Issue Description: `EWB-445 <http://jira.nilu.no/browse/EWB-445>`_
  | Fix: svn r1948


* :ref:`EBASprogram_ebas_insert`: ADDED for AE33 level 0 template:

  * new metadata elements (ebasmetadata)
  * new exceptional masterdata (CO, PM, IP, CV)
  * ADD exceptions for QC masterdata


  | Fix: svn r1981, r1982, r1983, r1984, r1996 (V.3.01.01)

* All ebas commandline programs: max volume std. temperature is now 298.15 (+25C)
  (was used in PSAP lev0)

  | Fix: svn r1993 (V.3.01.01)

* Exposed filter area (metadata): upper threshold value is nor 500 cm2

  | Fix: svn r2038 (V.3.01.02)

Bugfix:
=======


* :ref:`EBASprogram_ebas_extract`: crash when exporting QA metadata

  | Fix: svn r1969 (V.3.01.01)
  | Backport: svn r1968 (V.3.01.00)

* All ebas commandline programs: reading QA metadata did not work, no QA read

  | Fix: svn r1970 (V.3.01.01)
  | Backport: svn r1971 (V.3.01.00)

* :ref:`EBASprogram_ebas_insert`: Analytical measurement technique and
  analytical instrument name without manufacturer and model crashed

  | Fix: svn r1972 (V.3.01.01)
  | Backport: svn r1973 (V.3.01.00)

* :ref:`EBASprogram_ebas_insert`: problems with empty QA's (especially where
  setting QA elements to empty for a variable)

  | Fix: svn r1974 (V.3.01.01)
  | Backport: svn r1975 (V.3.01.00)

* :ref:`EBASprogram_ebas_insert`: fake component name in main header:
  calibration scale check and sensor type check fails

  | Issue Description: `EWB-445 <http://jira.nilu.no/browse/EWB-511>`_
  | Fix: svn r1976 (V.3.01.01)
  | Backport: svn r1977 (V.3.01.00)

* :ref:`EBASprogram_ebas_extract`: Format XML: gml:id is sometimes not unique

  | Issue Description: `EWB-285 <http://jira.nilu.no/browse/EWB-285>`_
  | Fix: svn r1986, r1988 (V.3.01.01)
  | Backported to :doc:`V.3.00.08<V.3.00.08>`, svn r1987, r1989

* :ref:`EBASprogram_ebas_insert`: crash in check_data when all values BDL and no
  DL set in metadata

  | Fix: svn r1978 (V.3.01.01)
  | Backport: svn r1980 (V.3.01.00)

* :ref:`EBASprogram_ebas_extract`: extra export interval when HAI changes
  mid-sample

  | Fix: svn r1992 (V.3.01.01)

* :ref:`EBASprogram_ebas_extract`: crash when writing lev0 files: metadata
  attribute was missing in I/O object

  | Fix: svn r2016 (V.3.01.02)
  | Backport: svn r2017 (V.3.01.01)

* :ref:`EBASprogram_ebas_insert`: crash when using unknown standard method

  | Fix: svn r2020 (V.3.01.02)
  | Backport: svn r2021 (V.3.01.01)

* ebas.io: Create Nasa Ames files - Volume std. pressure and temperature:
  accept other number types as float (crashed elsewise in nasa ames print
  header, which expected a string as metadata value)

  | Fix: svn r2025 (V.3.01.02)

* ebas.io: ORCID syntax: last digit is a checksum and may be 0-9 or X
  -> allow X in the last digit
  -> check checksum

  | Fix: svn r2026 (V.3.01.02)

* :ref:`EBASprogram_ebas_insert`: crash in check_interdep when detection limit
  is specified per variable but invalid

  | Fix: svn r2034 (V.3.01.02)

* :ref:`EBASprogram_ebas_insert`: Intervals of *different* measure ID's could
  not overlap.

  | Fix: svn r2039 (V.3.01.02)


Backported from future releases
===============================