README -- Describes contents of ExtData/FAST-JX/v2015-03 directory
05 Mar 2015
GEOS-Chem Support Team
geos-chem-support@g.harvard.edu


Overview:
===============================================================================

This directory contains the default temperature and ozone profiles (from
Nagatani 1992 and McPeters 1991) for input into the FAST-JX photolysis 
mechanism.  This data is overwritten by TOMS O3 data where available.


Files:
===============================================================================

fastj.jv_atms_dat.nc

 -- netCDF equivalent of the old ASCII file "jv_atms.dat", which
    contains default temperature and ozone profiles (on 51 levels,
    18 latitudes, and 12 months, from Nagatani 1992 and McPeters 1991) 
    for the FAST-JX photolysis scheme.  This data is overwritten by 
    TOMS O3 data where available.


References:
===============================================================================

* Wild, O., X. Zhu, and M. J. Prather, "Fast-J: Accurate simulation of 
   in- and below-cloud photolysis in tropospheric chemical models", 
   __J. Atmos. Chem.__, 37, 245282, 2000. 

Also see the following wiki pages

* http://wiki.geos-chem.org/FAST-J_photolysis_mechanism

* http://wiki.geos-chem.org/FAST-JX_v7.0_photolysis_mechanism


Making the data file COARDS-compliant:
===============================================================================

Bob Yantosca wrote the following script to edit the variable attributes
of the file fastj.jv_atms_dat.nc, for better COARDS-compliance.

   #!/bin/tcsh
   
   # Script to modify attributes for better COARDS compliance
   # Bob Yantosca (yantosca@seas.harvard.edu), 05 Mar 2015
   
   set file = "fastj.jv_atms_dat.nc"
   
   # Fix coordinate vector attributes
   ncatted -a axis,lat,o,c,"Y"          $file
   ncatted -a axis,lev,o,c,"Z"          $file
   ncatted -a positive,lev,o,c,"up"     $file
   
   # Fix variable attributes
   ncatted -a add_offset,T,o,d,0        $file
   ncatted -a scale_factor,T,o,d,1      $file
   ncatted -a missing_value,T,o,d,1e15  $file
   ncatted -a _FillValue,T,o,d,1e15     $file
   ncatted -a add_offset,O3,o,d,0       $file
   ncatted -a scale_factor,O3,o,d,1     $file
   ncatted -a missing_value,O3,o,d,1e15 $file
   ncatted -a _FillValue,O3,o,d,1e15    $file
   
   # Fix global attributes
   ncrename -a title,Title              $file
   ncrename -a institution,Institution  $file
   ncrename -a source,Source            $file
   ncrename -a history,History          $file
   ncrename -a references,References    $file
   ncrename -a comment,Comment          $file
   ncrename -a conventions,Conventions  $file
   ncrename -a format,Format            $file
   ncrename -a model,Model              $file
   ncrename -a nlayers,NLayers          $file
   ncrename -a start_date,Start_Date    $file
   ncrename -a start_time,Start_Time    $file
   ncrename -a end_date,End_Date        $file
   ncrename -a end_time,End_Time        $file
   ncrename -a delta_lon,Delta_Lon      $file
   ncrename -a delta_lat,Delta_Lat      $file
   ncrename -a delta_time,Delta_Time    $file
   
   unset $file
   
   exit(0)