How to Set Up the Post Processing Package
-----------------------------------------

Create a directory in your home directory or elsewhere that shall contain
all the python related code that is required for you to experiment.

For our example, I will call this directory "my_python_modules". I will
create this directory in my HOME directory which is "/users/tejasvi"

  $ cd
	
  $ pwd
  /users/tejasvi
	
  $ mkdir my_python_modules

  $ ls
  my_python_modules  mail  README  images

Now unpack the tar that contains the python code into the directory
created. The tar file is "postprocess.tar.gz"

   $ cd my_python_modules

   $ pwd
   /users/tejasvi/my_python_modules

   $ tar xvzf postprocess.tar.gz

Notice that this will extract all the post-processing code into a directory
called postprocess. The other required modules for the post-processing
filters to work are the filter configuration file parsing module and the
namespace file parser modules. These shall be present in the top level
directory that you created. In the example shown above, it was
"my_python_modules".

   $ ls
   filter_config_parser  namespace_parser  postprocess  README

Now, set your PYTHONPATH environment variable to point to the directory
that you created at the start. In the example shown above, this directory
would be "/users/tejasvi/my_python_modules"

    $ echo $SHELL


If you are using bash , use

    $ export PYTHONPATH=$PYTHONPATH:/users/tejasvi/my_python_modules

If you are using tcsh, use

    $ setenv PYTHONPATH ${PYTHONPATH}:/users/tejasvi/my_python_modules

You can now test the post processing examples that are present in the
"postprocess/examples" directory

The "dstream_filter.py" program is in the "postprocess" directory. This is
the program that lets you run all the filters.


The Filter Config file parsing module and the namespace parser module
----------------------------------------------------------------------

When you unpacked the postprocessing tar, these modules will have also been
extracted to "my_python_modules".

The directories are:

1. namespace_parser - Namespace parser
2. filter_config_parser - Filter config parser

   $ pwd
   /users/tejasvi/my_python_modules

   $ ls
   filter_config_parser  namespace_parser  postprocess  README

Please have a look at the README in the specific directory for specific
instructions on how to use the package to read and write the configuration
files using those modules. The directories also contain example scripts and
example configuration files.