
=========================================================================

coplot_magsphe pack
-------------------

P. Robert, LPP, June 2010

This pack available for Windows, allowing 2-D magnetosphere plot,
in meridian plane, from Tsyganenko model.

   -Plane can be GSM or GSE.
   -Sun can be set on the left side or on the righ side.
   -Earth is plotted, with continents, and turn correctly according
    asked date and time.
   -Kp indice can be automatically computed if Kp data base contain
    the asked date.
   -Computation is very fast for t87 or t89 Tsyganenko model.
   -Color choice is only aesthetics, and can be changed.
    A few examples of coplot_magsphe.in files and corresponding 
    coplot_magsphe.ps plots are given. 
    The user can choice to fill or not various zones with desired colors.
    The file colpal-22-10.ps is usefull to choose desired colors.
    
Usage: 
-----

   - edit coplot_magsphe.in file, and set date/time and other parameters
     if desired ;
   - double-clic on coplot_magsphe.bat file : a dos windows appears,
     computation are done, file coplot_magsphe.ps is created and
     following message appears :
     
     -------------------------------------------------------------------
     STOP coplot_magsphe: NORMAL TERMINATION
     File coplot_magsphe.ps available.
     In case of problems, see coplot_magsphe.out
     -------------------------------------------------------------------
     Strike any key to close this window ...

   - then double-clic on the coplot_magsphe.ps to open it.


Addendum for Cluster orbit plot
-------------------------------

     It is possible to add a plot of the CLUSTER Spacecraft, 
     and Tsyganenko field lines passing by each spacecraft.

   - edit coplot_magsphe_cluorbit.in file, and set date/time 
     and other parameters as previously.
     Add at the end a directory path containing .orb Cluster orbit files
     for the asked period, and add 3 days (revolution is about 2.5 days)
     You can use the data/Cluster_orbit directory to put your files.
   - double-clic on coplot_magsphe_cluorbit.bat file : 
     a dos windows appears as above, and file coplot_magsphe_cluorbit.ps
     is created
     
in case of any problems: patrick.robert@lpp.polytechnique.fr
Enjoy it !

=========================================================================