NAME

apit (Airshed Post-processing Interactive Tool)

SYNOPSIS

apit FILE [OPTION]

DESCRIPTION

     Post-process CIT-Airshed output data file and
     plot requested gas and aerosol phase species concentrations.
     All output files are saved in the current directory by default.

SYSTEM REQUIREMENTS

     Image Magick (http://www.imagemagick.org)
     Gri (http://gri.sourceforge.net)
     mpeg2encode only required for mpeg movies option.

OPTIONS

     -b
        Read input file in binary format.
        When option is not selected, FILE is assumed to be ASCII,
        converted to binary format, and saved as Binary.FILE.
        If FILE starts with word "Binary.", -b is assumed.

     -c
        Convert FILE to required input binary format only,
        and save output as Binary.FILE.
        When this option is set, all the others are ignored.

     -d{Binary.FILE2}
        Create Binary for the difference between FILE and FILE2.
        Useful to compare the changes of two output data files.

     --layer{N}
        Plot Ozone and NOx concentrations at upper layers.
         N   is an unique integer that identifies each layer.
             N must vary between 1 and 5.
        WARNING: Option not 100% compatible with other flags.
        Requires Marc Carreras fix to get additional ASCII data file.

     -m{'gif'|'mpeg'}
        Create a movie with the 24 contour maps from hourly values.
         'gif'  save as animated gif.
         'mpeg' save as mpeg. Requires at least 200 MB of
                disk space and 1GB of RAM. mpeg takes more
                time than gif option.
                Default value is 'gif'.

     --minmax
        Display on screen minimum and maximum of concentration field.

     --nox11
        Do not attempt to display the plots.

     -o{PREFIX}
        Add a PREFIX to all output files.

     -p{N}
        Plot time series at specific location.
         N is an unique integer that identifies each location.
           Default location is Riverside (N=483).

     -q{'2D'|'3D'}
        Set quality of contour map.
         3D shows better quality plots than 2D, but
         is more time consuming. Default value is 2D.

     -s{N|'pm'}
        Select gas/aerosol species to plot.
         N   is an unique integer that identifies each species.
             Default is Ozone (N=3).
        'pm' is a shortcut for PM2.5 and PM10 dry aerosol mass.

     -t{N|'avg'}
        Plot a contour map.
         N    is an integer that sets the hour (1-24). 
              N=0 plots a time series instead. When -t
              is set, -p is ignored. Default is 0.
        'avg' produces a 24-hour average concentration plot.

Help options:

--help Show this help message.
-l, --list Show list of all species and most common locations.

EXAMPLES:

1. Convert CIT-Airshed output data (FILE) to required binary input:

   apit FILE -c

2. Plot ozone time series in Riverside:

   apit Binary.FILE -s3 -p483

3. Plot PM2.5 and PM10 24-hour average concentrations contour maps:

   apit Binary.FILE -spm -tavg

4. Produce a mpeg movie with the hourly evolution of ozone using improved quality:

   apit Binary.FILE -s3 -mmpeg -q3D