vfnow Namespace Reference

A script for verification of numerical schemes in PISM. More...

Classes
class	PISMVerificationTest
	A class describing a refinement path and command-line options for a particular PISM verification test. More...
Functions
def	run_test
def	define_refinement_paths
Variables
int	KSPRTOL = 1
	get options; see --help msg for meaning default settings
int	SSARTOL = 5
int	nproc = 2
int	levels = 2
	default; will not use 'mpiexec' if equal to one
string	mpi = "mpiexec -np"
string	prefix = ""
string	test_names = "CGIJ"
list	userman_tests = ["B_userman", "G_userman", "K_userman", "I_userman"]
string	extra_options = "-verbose 1"
	do_userman = False
	debug = False
string	predo = "%s %d "
	exec_prefix = predo+prefix
tuple	tests = define_refinement_paths(KSPRTOL, SSARTOL)
tuple	N = len(tests[test].Mx)

---

Detailed Description

A script for verification of numerical schemes in PISM.

Author:

Ed Bueler and Constantine Khroulev, University of Alaska Fairbanks, USA

It specifies a refinement path for each of Tests ABCDEFGIJKL and runs pismv accordingly. Copyright (C) 2007--2011 Ed Bueler and Constantine Khroulev

Organizes the process of verifying PISM. It specifies standard refinement paths for each of the tests described in the user manual. It runs the tests, times them, and summarizes the numerical errors reported at the end.

Examples:

• vfnow.py 

  use one processor and do three levels of refinement; this command is equivalent to

  vfnow.py -n 2 -l 2 -t CGIJ 

  ,

• vfnow.py -n 8 -l 5 -t J --prefix=bin/ --mpido='aprun -n' 

  will use

  aprun -n 8 bin/pismv 

  as the command and do five levels (the maximum) of refinement only on test J,

• vfnow.py -n 2 -l 3 -t CEIJGKLO 

  uses two processers (cores) and runs in about an hour,

• vfnow.py -n 40 -l 5 -t ABCDEFGIJKLO 

  will use forty processors to do all possible verification as managed by vfnow.py; don't run this unless you have a big computer and you are prepared to wait. For a list of options do

  test/vfnow.py --help 

  . Timing information is given in the vfnow.py output so performance, including parallel performance, can be assessed along with accuracy.

---

Function Documentation

def vfnow::define_refinement_paths	(		KSPRTOL,
			SSARTOL
	)

Definition at line 109 of file vfnow.py.

def vfnow::run_test	(		executable,
			name,
			level,
			extra_options = "",
			debug = False
	)

Definition at line 56 of file vfnow.py.

---

Variable Documentation

debug = False

Definition at line 309 of file vfnow.py.

do_userman = False

Definition at line 308 of file vfnow.py.

exec_prefix = predo+prefix

Definition at line 360 of file vfnow.py.

string extra_options = "-verbose 1"

Definition at line 307 of file vfnow.py.

int KSPRTOL = 1

get options; see --help msg for meaning default settings

Definition at line 299 of file vfnow.py.

tuple levels = 2

default; will not use 'mpiexec' if equal to one

Definition at line 302 of file vfnow.py.

mpi = "mpiexec -np"

Definition at line 303 of file vfnow.py.

tuple N = len(tests[test].Mx)

Definition at line 368 of file vfnow.py.

Referenced by PISMDefaultYieldStress::basal_material_yield_stress(), IceModel::calculateRedistResiduals(), IceModel::check_maximum_thickness(), IceModel::eigenCalving(), exactL_list(), geo_x(), geo_y(), geo_z(), IceModel::get_average_thickness(), getU(), IceModel::init_diagnostics(), main(), PAdTforcing::temp_time_series(), PAYearlyCycle::temp_time_series(), PALapseRates::temp_time_series(), PAForcing::temp_time_series(), and PAConstant::temp_time_series().

tuple nproc = 2

Definition at line 301 of file vfnow.py.

string predo = "%s %d "

Definition at line 357 of file vfnow.py.

prefix = ""

Definition at line 304 of file vfnow.py.

int SSARTOL = 5

Definition at line 300 of file vfnow.py.

tuple test_names = "CGIJ"

Definition at line 305 of file vfnow.py.

tuple tests = define_refinement_paths(KSPRTOL, SSARTOL)

Definition at line 362 of file vfnow.py.

list userman_tests = ["B_userman", "G_userman", "K_userman", "I_userman"]

Definition at line 306 of file vfnow.py.