Prerequisites

Before running an Optima2D test case make sure:

• to read (skim over) the user manual for OPTIMA2D
• that OPTIMA2D is installed:
  • compile a working version of OPITMA2D using the make file
  • have the executable OPTIMA2D_xx in a directory in your PATH variable or know where this executable is located;
    where xx is your operating system (ie. i686, ia64)
• to have the required files for your test case:
  • have an opt.inp file (input file for the run)
  • if you are using SNOPT, make sure to have a SNOPT.spc file
  • have a grid file (i.e. grid-new.g) with the prefix stated in opt.inp
  • if you running an optimization, also make sure to have the files: {}.bsp and {}.dvs (with same prefix as last step)

Running a test case

1. Create a new folder with the test case number (ie. 001) and copy all the input files into that folder (grids, opt.inp, ect.)
2. Go to the new folder and remove any previous run output files by the following commands:
   $ cd {folder name}
   $ rm rest*
3. Create (or edit) the file file_prefixes to have the following four lines:
   rest00
   rest00
   F
   F
4. Run OPTIMA2D using an output file
   $ OPTIMA2D_xx > screen
   or alternatively if the command is not in your PATH variable run
   $ {location}/optima/optima2D/OPTIMA2D_xx > screen
5. [Optional] Track Optima2D by using the following commands on a different terminal
   $ tail -f rest00-00.his
   for the flow-solve convergence history or
   $ tail -f screen
   for the optimization process
6. Wait until the command finishes
7. Look at the output and pray for no errors
8. [Optional] Celebrate

Restarting a run

If you killed the process in the middle of a run you can restart it by:
$ cd {folder}
$ OPTIMA2D_xx > screen
Please note: do not remove the files from the previous runs. Optima will use the restart information to continue from where it left off.

Running on hpacf or scinet

Ask someone.