* ARTS-XML-DATA-2-3-12

	* spectroscopy/Perrin/README, scattering/README,
	planets/Venus/SAT/README, planets/Mars/SAT/README:
	READMEs for folders missing them so far.

	* spectroscopy/Perrin_artscat34/README, planets/Venus/MPS/README,
	planets/Mars/MPS/README, planets/Earth/Fascod/README:
	Minor corrections/updates.



git-svn-id: https://radiativetransfer.org/svn/rt/arts-xml-data/trunk@9334 aaf1aab0-4228-0410-ad68-8dceda47f409

ChangeLog

+2015-06-17 Jana Mendrok <jana.mendrok@ltu.se>
+
+	* ARTS-XML-DATA-2-3-12
+
+	* spectroscopy/Perrin/README, scattering/README,
+	planets/Venus/SAT/README, planets/Mars/SAT/README:
+	READMEs for folders missing them so far.
+
+	* spectroscopy/Perrin_artscat34/README, planets/Venus/MPS/README,
+	planets/Mars/MPS/README, planets/Earth/Fascod/README:
+	Minor corrections/updates.
+
 2015-06-17 Jana Mendrok <jana.mendrok@ltu.se>
 
 	* ARTS-XML-DATA-2-3-11

planets/Earth/Fascod/README

@@ -3,7 +3,7 @@ This directory contains t/z/vmr field data from the FASCOD model
 - 5 atmospheric scenarios for different seasons and geographic locations (out of originally 6 scenarios - US Standard is currently missing)
 - 1D fields given 0-95km (originally: 0-120km)
 
-- complemented by "expanded" t/z fields covering altitudes up to 2000km. These have been consistently created for use with the IRI and IGRF data, assuming hydrostatic equilibrium and a constant temperature (within the profile as well as for all the 5 scenarios) at altitudes above 95km. NOTE: When using these data, it is highly recommended to use ARTS' z_fieldFromHSE method for adjusting the calculations z_field to hydrostatic equilibrium conditions (the ARTS internal z-over-p interpolation does not conserve this; enforcing hydrostatic equilibrium by applying z_fieldFromHSE brings back the z data closer to the original profile).
+- complemented by "expanded" t/z fields covering altitudes up to 2000km. These have been consistently created for use with the IRI and IGRF data, assuming hydrostatic equilibrium and a constant temperature (within the profile as well as for all the 5 scenarios) at altitudes above 95km. NOTE: When using these data, it is highly recommended to use ARTS' z_fieldFromHSE method for adjusting the calculation z_field to hydrostatic equilibrium conditions (the ARTS internal z-over-p interpolation does not conserve this; enforcing hydrostatic equilibrium by applying z_fieldFromHSE brings back the z data closer to the original profile).
 
 - for more on original data see:
 Anderson, G. P., S. A. Clough, F. X. Kneizys, J. H. Chetwynd, and E. P. Shettle (1986), AFGL atmospheric constituent profiles (0–120 km), AFGL, TR-86-0110.

planets/Mars/MPS/README

 This directory contains planet characterization data (atmospheric profiles,
 surface properties, and the like) for Mars
 
-Mars.meanRefIndex.n.xml
+Mars.surface_complex_refr_index_field.xml
 -----------------------
 - global field of surface refractive index
 - originating from dielectric constant data (real part only; hence imag. part

planets/Mars/SAT/README

+This directory contains cloud and dust data (single scattering properties and
+particle number density fields) for Mars
+
+Mars.Ls[0,90,180,270].[day,night].dust-[low,medium,high]/*.pnd_field__*.xml
+-----------------------
+- 1D number density fields for different cloud/dust types and cases
+- available for 4 seasons, day/night, and 3 dust loadings (corresponding to
+   atmospheric cases, except negligible dependence on solar activity; note that
+   atm case dependence only refers to different p-z-relation during
+   seasons/daytimes; it does so far NOT consider different cloud/dust conditions
+   in different seasons/daytimes)
+- data created by J. Mendrok (LTU) within ESA Planetary study
+- for more details see TechnicalNote3 of the ESA Planetary study
+
+Mars.scat_data__*.xml
+-----------------------
+- single scattering data for different cloud/dust types and cases
+- data created by J. Mendrok (LTU) within ESA Planetary study
+- for more details see TechnicalNote3 of the ESA Planetary study
+
+NOTE: single scattering data and number density fields form paired groups, which
+ are linked by cloud category (CO2ice or H2Oice or Dust) and bulk type (e.g.,
+ *-size-bulk). within the groups, one can choose different dielectric property
+ assumptions (RI-*) for the single scattering data and different altitude
+ distributions (e.g., *-mixed, *-profile) for the number density fields.
+See Consolidated Design Document of the ESA Planetary study for details on the
+ relation of single scattering and number density data and on the file name
+ layout.

planets/Venus/MPS/README

@@ -2,14 +2,14 @@ This directory contains planet characterization data (atmospheric profiles,
 surface properties, and the like) for Venus provided by MPS within ESA Planetary
 study. For more details see TechnicalNote2 of the ESA Planetary study.
 
-Venus.meanRefIndex.n.xml
+Venus.surface_complex_refr_index_field.xml
 ------------------------
 - global field of surface refractive index
 - originating from dielectric constant data (real part only; hence imag. part
 set to 0)
 - for more details see TechnicalNote2 of the ESA Planetary study
 
-Mars.t_surface.xml
+Venus.t_surface.xml
 -----------------------
 - global field of surface (=skin) temperature
 - single, mean condition field
@@ -31,7 +31,7 @@ For a couple of reasons finally selected data is taken from a number of differen
 
 - We need, however consistent, full-coverage (i.e., covering both the vmr and el.dens. regions) z and T data. This is available from the latest (ext*) data sets, hence we get z and T fields from those instead of merging them ourselves from the original data, where vmr/T and el.dens. come with their own z fields.
 
-- In the orginal el.dens. data, there are only 3 sets (day, night, night_cold) instead of the 5 scenarios (vira.day, vira.day_highlat, vira.night, spicav.night, spicav.night_cold) given, and assignment between the 3 and 5 cases is not claer. The latest (ext*) el.dens. data set contains data for all 5 scenarios (though originally sorted into day/ and night/ folders instead of into the 5 scenario folders) and seems to agree well with the T-fields for the different cases (assuming/indicating the el.dens.-over-z is not scenario dependend). Hence, we take the el.dens. fields from the ext* data.
+- In the orginal el.dens. data, there are only 3 sets (day, night, night_cold) instead of the 5 scenarios (vira.day, vira.day_highlat, vira.night, spicav.night, spicav.night_cold) given, and assignment between the 3 and 5 cases is not clear. The latest (ext*) el.dens. data set contains data for all 5 scenarios (though originally sorted into day/ and night/ folders instead of into the 5 scenario folders) and seems to agree well with the T-fields for the different cases (assuming/indicating the el.dens.-over-z is not scenario dependend). Hence, we take the el.dens. fields from the ext* data.
 
 
 In the following we document, which version (date) of the individual data is taken:

planets/Venus/SAT/README

+This directory contains cloud and haze data (single scattering properties and
+particle number density fields) for Venus
+
+Venus.[vira,spicav].[day,day_highlat,night,night_cold]/*.pnd_field__*.xml
+-----------------------
+- 1D number density fields for different cloud/haze layers, modes, and cases
+- available for 5 scenarios from different data sources (VIRA and SPICAV),
+  for 2 times of day (day,night). note that scenario dependence only refers to
+  different p-z-relation; it does so far NOT reflect possible different cloud
+  conditions, e.g., in different daytimes.
+- data created by J. Mendrok (LTU) within ESA Planetary study
+- for more details see TechnicalNote3 of the ESA Planetary study
+
+Venus.scat_data__*.xml
+-----------------------
+- single scattering data for different cloud/haze layers and modes
+- data created by J. Mendrok (LTU) within ESA Planetary study
+- for more details see TechnicalNote3 of the ESA Planetary study
+
+NOTE: single scattering data and number density fields form paired groups, which
+ are linked by cloud category (H2SO4) and bulk type (layer and mode, *-bulk).
+ within the groups, one can choose different altitude distributions (*-profile)
+ for the number density fields.
+See Consolidated Design Document of the ESA Planetary study for details on the
+ relation of single scattering and number density data and on the file name
+ layout.

scattering/README

+This directory data related to running scattering calculations. Major part is
+single scattering data for different types of (well-defined) scattering particles.
+
+H2O_liquid/*.xml
+-----------------------
+- single scattering data (*.um.xml) and corresponding meta data (*um.meta.xml)
+- liquid water particles (e.g. for Earth liquid clouds and rain)
+- range of sizes (0.1-10,000um), all assumed as spheres
+- data created by ARTS developers using atmlab routines (Maetzler's matlab Mie code; dielectric property routines)
+- for more details data headers
+
+H2O_ice/*.xml
+-----------------------
+- single scattering data (*.um.xml) and corresponding meta data (*um.meta.xml)
+- water ice particles (e.g. for Earth ice clouds, hail, snow)
+- range of sizes (0.1-10,000um), all assumed as solid spheres
+- data created by ARTS developers using atmlab routines (Maetzler's matlab Mie code; dielectric property routines)
+- for more details data headers
+
+fosangles_360.xml
+-----------------------
+- set of directions/angles (polar and azimuth angles) for FOS calculations
+  (radiation path directions)
+- directions are equally distributed over the sphere, each representing a solid
+  angle of 4Pi/360 sr
+- data created by P. Eriksson (Chalmers)

spectroscopy/Perrin/README

+This directory contains a spectroscopic line catalogue.
+
+NOTE: currently Hitran-source data is not up-to-date. (to be fixed by Oliver/Richard)
+
+- prepared as part of ESA ESA Planetary Toolbox study. For more information see
+  the ESA study's Technical Note 3.
+- specifically prepared for planetary radiative transfer
+- covers data for frequencies <3THz
+- data is of unified ARTSCAT-5 format
+
+
+Species overview
+================
+
+Species  #    Source
+C2H2    (26)  Hitran
+C2H4    (38)  Hitran  NOL* (701.202696)
+C2H6    (27)  Hitran  NOL* (706.601510)
+C3H8          Perrin  [NOH*]
+C4H2    (43)  Hitran
+CF4     (42)  Hitran  NOL* (594.580718)
+CH3Br   (40)  Hitran  NOL* (794.403140)
+CH3CN   (41)  Hitran  NOL* (890.051655)
+CH3Cl   (24)  Hitran
+CH3OH   (39)  Hitran
+CH4     (6)   Perrin
+CO      (5)   Perrin
+CO2     (2)   Perrin
+COF2    (29)  Hitran  NOL* (686.730618)
+CS      (46)  Hitran
+ClO     (18)  Hitran
+ClONO2  (35)  Hitran  NOL* (763.641040)
+H2      (45)  Hitran
+H2CO    (20)  Perrin
+H2O     (1)   Perrin
+H2O2    (25)  Perrin
+H2S     (31)  Perrin
+H2SO4         Perrin
+HBr     (16)  Hitran
+HCN     (23)  Hitran
+HC3N    (44)  Hitran
+HCOOH   (32)  Hitran
+HCl     (15)  Perrin
+HF      (14)  Perrin
+HI      (17)  Hitran
+HNO3    (12)  Hitran
+HO2     (33)  Perrin
+HOBr    (37)  Hitran
+HOCl    (21)  Hitran
+N2      (22)  Hitran
+N2O     (4)   Hitran
+NH3     (11)  Perrin
+NO      (8)   Hitran
+NO+     (36)  Hitran  NOL* (1634.831153)
+NO2     (10)  Hitran
+O       (34)  Hitran
+O2      (7)   Perrin
+O3      (3)   Perrin
+OCS     (19)  Perrin
+OH      (13)  Hitran
+PH3     (28)  Perrin
+SF6     (30)  Hitran  NOL* (580.000244)
+SO            Perrin
+SO2     (9)   Perrin
+SO3     (47)  Hitran
+
+NOL*:    No lines between 0-3THz (1st linepos in HITRAN [cm-1])
+NOH*:    No lines in HITRAN yet at all
+
+Perrin' spectroscopic line database
+==================================
+
+Latest version:
+
+Nov 23  2012 C3H8.xml.gz
+Mar 15  2012 CH4.xml.gz
+Mar 17  2014 CO.xml.gz
+Jan 29  2014 CO2.xml.gz
+Mar  1  2012 H2CO.xml.gz
+Jan 29  2014 H2O.xml.gz
+Mar 15  2012 H2O2.xml.gz
+Mar  1  2014 H2S.xml.gz
+Mar 15  2012 H2SO4.xml.gz
+Mar 17  2014 HCl.xml.gz
+Mar  1  2014 HF.xml.gz
+Aug 23  2012 HO2.xml.gz
+Mar 15  2012 NH3.xml.gz
+Feb  6  2014 O2.xml.gz
+Feb  6  2014 O3.xml.gz
+Mar  1  2014 OCS.xml.gz
+Mar 15  2012 PH3.xml.gz
+Apr  7  2014 SO.xml.gz
+Feb  6  2014 SO2.xml.gz
+
+
+Unit conversion values used:
+
+           ccc=29979.2458d+14
+           Joule=5.03411701D+22
+c          E"(ARTS)=E"(HITRAN)/Joule
+           HzPa=0.33798382D-05
+c          Gamma(ARTS)=Gamma(HITRAN)/HzPa
+           ZIarts=2.99792458D+6
+c          Int(ARTS)=Int(HITRAN)*ZIarts
+           sarts=2.99792458D+10
+c          sigm(ARTS)=sigm(HITRAN)*sarts
+
+
+
+Species from Hitran
+===================
+
+Latest version: 2012 edition
+
+2015-06-09 17:05 C2H2.xml.gz
+2015-06-09 17:06 C4H2.xml.gz
+2015-06-09 17:05 CH3Cl.xml.gz
+2013-01-11 09:07 CH3OH.xml.gz
+2015-06-09 17:05 ClO.xml.gz
+2015-06-09 17:06 CS.xml.gz
+2015-06-09 17:06 H2.xml.gz
+2015-06-09 17:05 HBr.xml.gz
+2015-06-09 17:06 HC3N.xml.gz
+2012-03-19 11:03 HCN.xml.gz
+2015-06-09 17:05 HCOOH.xml.gz
+2015-06-09 17:05 HI.xml.gz
+2015-06-09 17:05 HNO3.xml.gz
+2015-06-09 17:05 HOBr.xml.gz
+2015-06-09 17:05 HOCl.xml.gz
+2012-03-19 11:03 N2O.xml.gz
+2015-06-09 17:05 N2.xml.gz
+2015-06-09 17:05 NO2.xml.gz
+2015-06-09 17:05 NO.xml.gz
+2015-06-09 17:05 OH.xml.gz
+2012-03-19 11:03 O.xml.gz
+2015-06-09 17:06 SO3.xml.gz
+
+
+Empty files for species with no (THz) lines
+===========================================
+(but required as broadening species (*) or due to existence of Earth profile data)
+
+2012-03-19 11:03 C2H6.xml.gz
+2012-03-19 11:03 COF2.xml.gz
+2012-11-24 02:04 He.xml.gz
+2012-03-19 11:03 SF6.xml.gz
+
+
+Line Count
+==========
+
+- abs_lines_per_speciesCreateFromLines
+  0: N2O-*-*-*: 451 lines
+  1: NO-*-*-*: 5233 lines
+  2: NO2-*-*-*: 20170 lines
+  3: HNO3-*-*-*: 490086 lines
+  4: OH-*-*-*: 2111 lines
+  5: HBr-*-*-*: 326 lines
+  6: HI-*-*-*: 375 lines
+  7: ClO-*-*-*: 9453 lines
+  8: HOCl-*-*-*: 2952 lines
+  9: N2-*-*-*: 36 lines
+  10: HCN-*-*-*: 319 lines
+  11: CH3Cl-*-*-*: 12824 lines
+  12: C2H2-*-*-*: 40 lines
+  13: HCOOH-*-*-*: 6808 lines
+  14: O-*-*-*: 1 lines
+  15: HOBr-*-*-*: 1463 lines
+  16: CH3OH-*-*-*: 4663 lines
+  17: C4H2-*-*-*: 3744 lines
+  18: HC3N-*-*-*: 985 lines
+  19: H2-*-*-*: 34 lines
+  20: CS-*-*-*: 694 lines
+  21: SO3-*-*-*: 25 lines
+
+
+
+ARTS controlfile used to extract species from HITRAN data
+=========================================================
+see ExtractFromHITRAN.arts (run with -r 030 to create above line count)
+

spectroscopy/Perrin_artscat34/README

+This directory contains a spectroscopic line catalogue.
+
+- prepared as part of ESA ESA Planetary Toolbox study. For more information see
+  the ESA study's Technical Note 3.
+- specifically prepared for planetary radiative transfer
+- covers data for frequencies <3THz
+- data is of ARTSCAT-4 (source: Perrin) and ARTSCAT-3 (source: Hitran) format
+
+
 Species overview
 ================