trend
------------------------------------------------------------------------------

This family of scripts allows one to produce time-series outputs of CAM or
ExoCAM simulations from model outputs produced on a montly mean cadence.  
This primary use of this package is to determine model convergence characteristics 
and diagnose any residual trends.  The model assumes your directory structure
is set up in accordance with NCAR standards, $RUNDIR and $DOUT_S_ROOT (i.e. the
archive directory).

Requires exocampy_tools.py from ExoCAM/tools/py_progs

contains
------------------------------------------------------------------------------
trend.py         -- main program
trend_utils.py   -- contains functions for printing and plotting data
vars.in          -- contains lists of the variables to read in from
                    atmosphere, ice, and land model respectively

usage
------------------------------------------------------------------------------
usage: trend.py [-h] [-y Y] [-n N] [-p P] [--cam] [--cice] [--clm] [--rundir]
                [--plots] [--data]
                case_id

positional arguments:
  case_id     Set simulation time series case name

optional arguments:
  -h, --help  show this help message and exit
  -y Y        Start year over which to begin timeseries
  -n N        Number of months to integrate over
  -p P        Interval for screen output, in number of months
  --cam       read atmosphere model data
  --cice      read sea ice model data
  --clm       read land model data
  --rundir    read files from run directory instead of archive
  --plots     do not do lineplots at end of sequence
  --data      print to data file



example
------------------------------------------------------------------------------
>> python trend.py $my_case_name --cam -p 100 -y 10 --plots

result:
produces time-series from run titled "$my_case_name"
reads the atmosphere model files only "cam.h0"  (variables defined in vars.in)
read data from the archive directory
starts at date  0010-01
prints to screen once every 100 model months
plots data to screen