File: papco_user.txt                                             11/12/01


Notes on PAPCO --  Installing PAPCO user files and running PAPCO    


*** INSTALLING THE USER FILES ***

    Copy the  papco_user_09  directory hierarchy from another user into
    your home directory.  (It may be most convenient to make a tar file
    in your home directory, i.e.,
      cd ~other_user
      tar cf ~/papco_user_09.tar papco_user_09
      cd
      tar xvf papco_user_09.tar
    )

    Note:  The file  papco_set_variables.pro  has environment variables
    for the TIMAS group at Lockheed Martin.  For different computer systems,
    or for a new version of PAPCO, edit  papco_set_variables.pro .


*** ENVIRONMENT SETUP ***

    PAPCO does its own environment setup, however, to eliminate
    having to cd to  ~/papco_user_09  before running PAPCO, we are using
    an additional environment setup that extends the IDL path to include
     ~/papco_user_09 .

1.  If you are a member of the TIMAS group at Lockheed Martin, setup
    is automatic, i.e. we add the path  ~/papco_user_09  to your IDL_PATH
    variable, if you have the command
    
        source /timas/local/scripts/set_timas_env.csh
      
    in your  .cshrc  file.
    
    In that case skip the following SETUP steps.  (Our automatic setup
    also defines for you the aliases in Step 3 below.)
    
2.  Extend the IDL path by either a) changing the environment variable
    IDL_PATH or by b) changing the  !path  variable in an  idl_startup.pro
    file.

    Either
    a)  Add the following line to your .cshrc file.

          setenv IDL_PATH ${IDL_PATH}:${HOME}/papco_user_09   

    or
    b)  Make a file  idl_startup.pro  (in some convienient directory in your
    own directory tree) that adds the PAPCO path to IDL's path.  That is,
    contains the command
        
       !path = !path + ':~/papco_user_09'
       
    Then add the following line to your  .cshrc :

       setenv IDL_STARTUP $HOME<path>/idl_startup
       
    where <path> is the location of  idl_startup.pro  below your home
    directory.
    
3.  Add the following lines to your  .cshrc :

       alias papco 'idl papco_autostartup'
       alias papco_setup 'idl papco_setup'

    Use papco_setup when you need to change the module buttons on your
    PAPCO Plot Composer.

4.  Give the command
    
       source .cshrc
       
 
*** TO ADD MODULES TO PAPCO ***

1.  Install any new modules (can be either under  papco_xx/papco_modules  or
     papco_user_xx/papco_user_modules ).

2.  Give the command

       idl papco_setup   (or start idl and give the command @papco_setup)

3.  Click on the radio buttons for the new modules, if they are in papco_xx.
    Follow the instructions if the new modules are in papco_user_xx. 

4.  Select "New Config & Go on"

5.  Type

       papco
       
6.  For each new module (or each pulldown menu item under a module button):
    Select a module.  Select "Config".  Type in or browse for the directory
    path of the data for that module.  Select "Set" and "Save".  (This
    step can be done any time it is necessary to change the data directory.)        


*** TO COPY MODULE CONFIGURATION SETTINGS ***

If a module is not working correctly because its environment variables
are out-of-date, you may wish to copy the configuration file for that
module from another user.  Configuration files have the extension
.config and names like "polar_hydra.config".  Configuration files are
stored in the directory ~/papco_user_xx/papco_modules_defaults.


*** TO RUN ***

To run PAPCO from the UNIX command line, type

    papco
    
To run PAPCO from IDL, type

    @papco_autostartup
    
or, if PAPCO has already been started and exited in the same IDL session,
just type

    papco
        
(at the "IDL>" prompt) to restart PAPCO.

To run PAPCO from a desktop icon (Sun Solaris CDE), 

   a.  Click Application Manager (File drawer icon with pencil, etc.)   
   
   b.  Double click Desktop_Apps
   
   c.  Double click Create Action
   
   d.  Enter Action Name: PAPCO
   
   e.  Enter Command: csh -c 'idl papco_autostartup'
   
   f.  Select Window Type: Terminal (Auto-Close)
   
   g.  Select File/Save
   
   h.  To edit the action, start Create Action again, select File/Open, and
       then select  PAPCO.dt .

   i.  To copy the icon to the desktop, open filemanager and drag the
       PAPCO Action icon from your home directory onto the desktop.
       
To run PAPCO SETUP from a desktop icon (Sun Solaris CDE)

   Do the same steps as above to run PAPCO from a desktop icon
   except make the Action Name
   
   SETUP
  
   and for the "Command" use
   
   csh -c 'idl papco_setup'


*** TERMINAL WINDOW INITIALIZATION SETTINGS ***

   To save more lines in the terminal window buffer, say 700, add the line

           Dtterm*saveLines: 700

   to  $HOME/.Xdefaults .  To start the terminal window with height,
   say 31 lines (instead of 24), add the line
       
           Dtterm.geometry: 80x31
           
   The settings will take effect at the next login to the CDE, or immediately
   if you
   
   a.  Click Application Manager (File drawer icon with pencil, etc.)   
   
   b.  Double click Desktop_Controls (or Desktop_Tools in older CDE versions) 
   
   c.  Double click Reload Resources