Options

[Documentation]

Options

• Options
  • Options

Options

--starting-iteration=n set starting iteration (default is 0)
--end-iteration=n set end iteration (default is the last one)
--force force recalculation of specified iterations
--iteration-report output a report (iteration_report.csv) on methods / layers for each iteration, without doing any calculations
--depth-statistics output mean, standard deviation, min, and max grids for the corrected and uncorrected base depth grids
--depth-stats-checkpoint=n output the depth stats every n, just in case
--spillpoint perform the spillpoint calculations and output mask grids
--spillpoint-sum compute the sum of the spillpoint mask grids
--spillpoint-checkpoint=n output the checkpoint sum every n, just in case
--spillpoint-flexed-depth use the error corrected depth for the spillpoint analysis (default is to use the uncorrected depth)
--spillpoint-owc=n use the specified OWC value in volumetrics, rather than assuming the strucutre is full-to-spill
--spillpoint-statistics output a summary of the spillpoint calculations to spill_statistics.csv
--depth-stdev-threshold=n only do the depth stats / spillpoint if the stdev of depth errors is less than n
--report=n output an html report on iteration n to report.html. Xval does a cross-validation run automatically if you choose to make a report, which is very useful for checking that a deterministic case picked from a multi-model cross-validation run has actually done what is expected.
--report-all output an html report on all the iterations run. Implies skip-if-locked and skip-if-done-already
--report-skip-if-done-already Normally, specifying a report forces the computation to be re-done. This option makes it possible to skip iterations for which the report has already been run.
--output-intermediate-files save all the intermediate maps to disk (this includes the depth maps plus all the velocities etc
--output-intermediate-maps save all the intermediate maps to disk (this includes the depth maps plus all the velocities etc
--nooutput-intermediate-maps Don't.
--output-intermediate-depth-maps save all the intermediate depth maps to disk
--nooutput-intermediate-depth-maps Don't.
--threshold=n set the grid paging threshold. Default is 200.
--overnight only run the numbercrunching overnight
--overload by default, if the system load is greater than the number of CPSs then the program will sleep. Supplying the --overload option overrides this behaviour and insists on the program running even if the computer is overloaded
--run-on-battery as above, but force running when on battery power
--cross-validate=s Cross-validate by dropping out up to n wells. If the value "specified" is used then all the wells listed in the file given in --cross-validate-specified will be dropped out at once, as a one-shot.
--cross-validate-specified=s Cross-validate wells listed in this file. File has one well per line.
--validation-radius=n Drop out wells which are within this distance of each other as a cluster
--xval-rms-threshold=n only do this iteration if the RMS error from the cross validation is less than this value. Note that this flag should not be used at the same time as the --cross-validate flag; use --cross-validate first to build up the statistics, and then run with this flag to exclude poor realisations.
--xval-threshold-corrected use the RMS of the corrected values in thresholding. Default is to use the uncorrected valued
--cross-validation-stats update the stats file and then exit
--cross-validation-max-runs=n stop after this number of cross-validation runs (one run is a complete dropping-out set of several iterations)
--max-rms Same as xval-rms-threshold, but when using the entry point sprint_best_from_crossvalidation
--skip=n Skip this number of iterations when the current one is locked. Only useful when using more than one CPU.
--unlock Forcibly unlock everything. Do not use this if running on more than one CPU
--output-final-vavg-map Output a map of average velocity to the error-corrected final horizon. Mainly for use with Pete's Sausage machine.
--nooutput-final-vavg-map Don't
--restart Delete the timestamp file and start from the beginning again (otherwise, results are cached on disk). Use this when the input data have changed.
--fill-time-horizons If an input time horizon is undefined anywhere, use values from the previous time horizon to fill in. Useful for tilted eroded reservoir sequences, or large-throw faults.
--make-conformal Ensure there are no negative isochrons. Where the horizons cross, truncate the deeper against the shallower.
--verbose=n How verbose to be. Value between 0 and 9 inclusive. 0 means no output at all. 5 is normal. 9 is extra debug.
--output-wedge Output a wedge-grid for each horizon_iteration combination.
--volumetrics Run volumetrics. Only use this when the deepest time horizon is the Top Reservoir horizon. If a Base Reservoir time horizon exists then per-layer volumetrics using the contact array need to be used.
--grv-uncertainty Run a geostatistical simulation on the final depth surface before invoking either volumetric or spillpoint calculations
--grv-simulation-runs=n How many geostatistical simulations to perform. Default is 100.
--min-layering-layers When running different layering scenarios, ignore cases which have fewer than this number of layers.
--max-layering-layers When running different layering scenarios, ignore cases which have more than this number of layers.
--not-montecarlo Use heuristics based on cross_validation_stats.txt to choose methods, rather than pure monte-carlo, when cross-validating
--weight-not-monte=n Weighting factor for non-montecarlo crossvalidation method selection
--power-min-not-monte=n ditto
--power-count-not-monte=n ditto
--multiplier-not-monte=n ditto
--unused-multiplier=n ditto
--worst-multiplier=n If the worst value is greater than n * the best value, give it the same weight as the best value as this isn't fair, but only if the method hasn't been tried very often.
--pdl-pthread=n use n pthreads on multi-cpu machine. Note this doesn't actually seem to speed anything up in my tests so far
--fork-png-output fork a separate process to create PNG images so this happens in parallel. Can end up with 2 or 3 extra processes running in parallel, which is a good thing on a multi-cpu machine if this is the only process running.
--clean clean out all temporary and intermediate files which might be left over from an aborted run. Note this works on filename patterns, so there's no guarantee user-created files won't be deleted. Use with caution and make sure you have a backup.
--deep-clean clean out all files made by Xval including results; only the input data is left. Note this works on filename patterns, so there's no guarantee user-created files won't be deleted. Use with caution and make sure you have a backup.