Create Data Input Files

  1. Make a directory to run ipars

    <water>/h1/gxl/IPARS/IPARSv2/work/ mkdir Run
    <water>/h1/gxl/IPARS/IPARSv2/work/ cd Run
    <water>/h1/gxl/IPARS/IPARSv2/work/Run/ ln -s ../ipars .s

    Note: ipars can be run in the same place as it was built

  2. Input file should be compatible with the executable as far as model/solver/vis etc. are concerned.
  3. Dimensions should be compatible with the MAX bounds for arguments as defined in sizefiles.
  4. When creating an input file it is better to modify an existing file than start from scratch.
    • Do not use TAB symbols or unusual things may happen !
    • Use $ symbol to comment things out in the input file.
  5. Copy an existing data input file to the directory where ipars will be run
    • Assume hydrology implicit model is build
    <water>/h1/gxl/IPARS/IPARSv2/work/Run cp
    ../../data/hydro1.dat mytest.dat
  6. Modify the input file
    • Modify mytest.dat and change TIMEEND to 10.0 (days)

Run IPARS

  1. Interactive mode

    <water>/h1/gxl/IPARS/IPARSv2/work/Run/ ./ipars
    ENTER INPUT FILE NAME:
    hydro1.dat
    ENTER OUTPUT FILE NAME:
    hydro1.out
    ENTER INPUT RESTART FILE NAME (RETURN IF NONE):
    ENTER OUTPUT RESTART FILE PRIMARY NAME (RETURN IF NONE):
    # of GMRES itns = 8 res.err= .679143548
    # of GMRES itns = 9 res.err= .00119301397
    # of GMRES itns = 9 res.err= 3.63559161E-06
    STEP 1 TIME 1.20 OIL 1.0000000 WAT 1.0000000 NEWT 3 LINR 9
    # of GMRES itns = 9 res.err= .0319111682
    # of GMRES itns = 9 res.err= .00196011434
    # of GMRES itns = 9 res.err= 3.29029604E-06
    ……
    STEP 6 TIME 10.00 OIL 1.0000000 WAT 1.0000000 NEWT 2 LINR 10
    STOP 0 statement executed
  2. Use batch file IPARS.IN
    <water>/h1/gxl/IPARS/IPARSv2/work/Run cat IPARS.IN
    hydro1.dat
    hydro1.out

    <water>/h1/gxl/IPARS/IPARSv2/work/Run/ ./ipars
    # of GMRES itns = 8 res.err= .679143548
    # of GMRES itns = 9 res.err= .00119301397
    # of GMRES itns = 9 res.err= 3.63559161E-06
    STEP 1 TIME 1.20 OIL 1.0000000 WAT 1.0000000 NEWT 3 LINR 9
    # of GMRES itns = 9 res.err= .0319111682
    # of GMRES itns = 9 res.err= .00196011434
    # of GMRES itns = 9 res.err= 3.29029604E-06
    ……
    STEP 6 TIME 10.00 OIL 1.0000000 WAT 1.0000000 NEWT 2 LINR 10
    STOP 0 statement executed

    Note: two empty lines at the end of IPARS.IN

Standard Ouput

  1. Check for errors in output, in particular, for any string ERR* in the standard output file.
  2. If everything went well, you should have some results in the output files according to what was requested in the input file.
    Example: Look at the results in the output file hydro1.out and in the well file HYDRO1.WEL
    <water>/h1/gxl/IPARS/IPARSv2/work/Run/ ls
    hydro1.dat, hydro1.out (Standard output), HYDRO1.WEL (Well output ) ipars

Restart Run

  1. Specify restart output time in a data file.
    • TIMRES = Time for restart output
    • DTIMRES = Time between scheduled restart outputs
    • Example: Modify hydro1.dat
    TIMRES = 2.0
    DTIMRES = 2.0
  2. Specify restart input/output files when running ipars
    • Give restart output file name in an initial run
    • Give restart input/output file names in a restart run
  3. Initial runs
    • Interactive mode

    <water>/h1/gxl/IPARS/IPARSv2/work/Run/ ./ipars
    ENTER INPUT FILE NAME:
    hydro1.dat
    ENTER OUTPUT FILE NAME:
    hydro1.out
    ENTER INPUT RESTART FILE NAME (RETURN IF NONE):
    ENTER OUTPUT RESTART FILE PRIMARY NAME (RETURN IF NONE):
    myrestart
    # of GMRES itns = 8 res.err= .679143548
    # of GMRES itns = 9 res.err= .00119301397
    # of GMRES itns = 9 res.err= 3.63559161E-06
    STEP 1 TIME 1.20 OIL 1.0000000 WAT 1.0000000 NEWT 3 LINR 9
    # of GMRES itns = 9 res.err= .0319111682
    # of GMRES itns = 9 res.err= .00196011434
    # of GMRES itns = 9 res.err= 3.29029604E-06
    ……
    STEP 6 TIME 10.00 OIL 1.0000000 WAT 1.0000000 NEWT 2 LINR 10
    STOP 0 statement executed

    • Batch file, initial run

    <water>/h1/gxl/IPARS/IPARSv2/work/Run/ cat IPARS.IN
    hydro1.dat
    hydro1.out
    myrestart
    <water>/h1/gxl/IPARS/IPARSv2/work/Run/ ./ipars
    # of GMRES itns = 8 res.err= .679143548
    # of GMRES itns = 9 res.err= .00119301397
    # of GMRES itns = 9 res.err= 3.63559161E-06
    STEP 1 TIME 1.20 OIL 1.0000000 WAT 1.0000000 NEWT 3 LINR 9
    # of GMRES itns = 9 res.err= .0319111682
    # of GMRES itns = 9 res.err= .00196011434
    # of GMRES itns = 9 res.err= 3.29029604E-06
    ……
    STEP 6 TIME 10.00 OIL 1.0000000 WAT 1.0000000 NEWT 2 LINR 10
    STOP 0 statement executed

  4. Restart output files
    <water>/h1/gxl/IPARS/IPARSv2/work/Run/ ls myrestart*
    myrestart.10 myrestart.2 myrestart.4 myrestart.6 myrestart.8
  5. Restart Runs

    <water>/h1/gxl/IPARS/IPARSv2/work/Run/ ./ipars
    ENTER INPUT FILE NAME:
    hydro1.dat
    ENTER OUTPUT FILE NAME:
    hydro1.out
    ENTER INPUT RESTART FILE NAME (RETURN IF NONE):
    myrestart.8
    ENTER OUTPUT RESTART FILE PRIMARY NAME (RETURN IF NONE):
    myrestart
    <water> /ices/gxl/ipars/IPARSv2/work/Run/ .ipars
    # of GMRES itns = 9 res.err= .0288425703
    # of GMRES itns = 9 res.err= .000279604748
    # of GMRES itns = 9 res.err= 3.0205166E-07
    STEP 9 TIME 9.02 OIL 1.0000000 WAT 1.0000000 NEWT 3 LINR 9
    # of GMRES itns = 9 res.err= .00233964203
    # of GMRES itns = 9 res.err= 1.22894244E-06
    STEP 10 TIME 10.00 OIL 1.0000000 WAT 1.0000000 NEWT 2 LINR 9
    STOP 0 statement executed

    <water>/h1/gxl/IPARS/IPARSv2/work/Run/ cat IPARS.IN
    hydro1.dat
    hydro1.out
    myrestart
    <water>/h1/gxl/IPARS/IPARSv2/work/Run/ ./ipars
    # of GMRES itns = 8 res.err= .679143548
    # of GMRES itns = 9 res.err= .00119301397
    # of GMRES itns = 9 res.err= 3.63559161E-06
    STEP 1 TIME 1.20 OIL 1.0000000 WAT 1.0000000 NEWT 3 LINR 9
    # of GMRES itns = 9 res.err= .0319111682
    # of GMRES itns = 9 res.err= .00196011434
    # of GMRES itns = 9 res.err= 3.29029604E-06
    ……
    STEP 6 TIME 10.00 OIL 1.0000000 WAT 1.0000000 NEWT 2 LINR 10
    STOP 0 statement executed

 

Written by Center for Subsurface Modeling