rhessyscalibrator.model_runner_db.ModelRunnerDB Class Reference

Class for setting up, and storing modeling session and run information in a sqlite-base DB. More...

Inheritance diagram for rhessyscalibrator.model_runner_db.ModelRunnerDB:

Public Member Functions
def	__init__ (self, db_path)
	Initialize the DB. More...
def	__del__ (self)
def	close (self)
def	getMostRecentSessionID (self)
	Returns the ID of the session most recently inserted by the given instance of ModelRunnerDB. More...
def	insertSession (self, user, project, notes, iterations, processes, basedir, cmd_proto)
	Creates a new session with a starttime of the current time, and a status of 'submitted'. More...
def	updateSessionEndtime (self, id, endtime, status)
	Updates the end time and the status of the given session. More...
def	updateSessionObservationFilename (self, id, obs_filename)
	Updates the obs_filename used for calculating model fitness statistics for runs associated with the session. More...
def	getMostRecentRunID (self, session_id)
	Returns the ID of the run most recently inserted by the given instance of ModelRunnerDB. More...
def	insertRun
	Creates a new run with a starttime of the current time, and a status of 'PEND'. More...
def	updateRunEndtime (self, id, endtime, status)
	Updates the end time and the status of the given run. More...
def	getRunStatus (self, id)
	Gets the status of the given run. More...
def	updateRunStatus
	Updates the status of the given run. More...
def	updateRunJobId (self, id, job_id)
	Updates the job_id of the given run. More...
def	updateRunFitnessResults
	Updates fitness results of a model run. More...
def	getRun (self, run_id)
	Get the run with the supplied ID. More...
def	getRunsInSession
	Get all runs associated with a session. More...
def	getRunInSession (self, session_id, job_id)
	Get all runs associated with a session. More...
def	getSession (self, session_id)
	Get the session with the supplied ID. More...
def	getSessions (self)
	Get all sessions in the DB. More...
def	__init__ (self, db_path)
	Initialize the DB. More...
def	__del__ (self)
def	close (self)
def	getMostRecentSessionID (self)
	Returns the ID of the session most recently inserted by the given instance of ModelRunnerDB. More...
def	insertSession (self, user, project, notes, iterations, processes, basedir, cmd_proto)
	Creates a new session with a starttime of the current time, and a status of 'submitted'. More...
def	updateSessionEndtime (self, id, endtime, status)
	Updates the end time and the status of the given session. More...
def	updateSessionObservationFilename (self, id, obs_filename)
	Updates the obs_filename used for calculating model fitness statistics for runs associated with the session. More...
def	getMostRecentRunID (self, session_id)
	Returns the ID of the run most recently inserted by the given instance of ModelRunnerDB. More...
def	insertRun
	Creates a new run with a starttime of the current time, and a status of 'PEND'. More...
def	updateRunEndtime (self, id, endtime, status)
	Updates the end time and the status of the given run. More...
def	getRunStatus (self, id)
	Gets the status of the given run. More...
def	updateRunStatus
	Updates the status of the given run. More...
def	updateRunJobId (self, id, job_id)
	Updates the job_id of the given run. More...
def	updateRunFitnessResults
	Updates fitness results of a model run. More...
def	getRun (self, run_id)
	Get the run with the supplied ID. More...
def	getRunsInSession
	Get all runs associated with a session. More...
def	getRunInSession (self, session_id, job_id)
	Get all runs associated with a session. More...
def	getSession (self, session_id)
	Get the session with the supplied ID. More...
def	getSessions (self)
	Get all sessions in the DB. More...
def	__init__ (self, db_path)
	Initialize the DB. More...
def	__del__ (self)
def	close (self)
def	getMostRecentSessionID (self)
	Returns the ID of the session most recently inserted by the given instance of ModelRunnerDB. More...
def	insertSession (self, user, project, notes, iterations, processes, basedir, cmd_proto)
	Creates a new session with a starttime of the current time, and a status of 'submitted'. More...
def	updateSessionEndtime (self, id, endtime, status)
	Updates the end time and the status of the given session. More...
def	updateSessionObservationFilename (self, id, obs_filename)
	Updates the obs_filename used for calculating model fitness statistics for runs associated with the session. More...
def	getMostRecentRunID (self, session_id)
	Returns the ID of the run most recently inserted by the given instance of ModelRunnerDB. More...
def	insertRun
	Creates a new run with a starttime of the current time, and a status of 'PEND'. More...
def	updateRunEndtime (self, id, endtime, status)
	Updates the end time and the status of the given run. More...
def	getRunStatus (self, id)
	Gets the status of the given run. More...
def	updateRunStatus
	Updates the status of the given run. More...
def	updateRunJobId (self, id, job_id)
	Updates the job_id of the given run. More...
def	updateRunFitnessResults
	Updates fitness results of a model run. More...
def	getRun (self, run_id)
	Get the run with the supplied ID. More...
def	getRunsInSession
	Get all runs associated with a session. More...
def	getRunInSession (self, session_id, job_id)
	Get all runs associated with a session. More...
def	getSession (self, session_id)
	Get the session with the supplied ID. More...
def	getSessions (self)
	Get all sessions in the DB. More...

Detailed Description

Class for setting up, and storing modeling session and run information in a sqlite-base DB.

A model runner DB stores information about modeling sessions. A session is composed of one or more modeling runs. There is a one-to-many relationship between sessions and runs (i.e. a session can be associated with many runs, but a run can only be associated with a single session)

Constructor & Destructor Documentation

def rhessyscalibrator.model_runner_db.ModelRunnerDB.__init__	(		self,
			db_path
	)

Initialize the DB.

Will create a connection to the sqlite DB pointed to by db_path

def rhessyscalibrator.model_runner_db.ModelRunnerDB.__del__

(

self

)

def rhessyscalibrator.model_runner_db.ModelRunnerDB.__init__	(		self,
			db_path
	)

Initialize the DB.

Will create a connection to the sqlite DB pointed to by db_path

def rhessyscalibrator.model_runner_db.ModelRunnerDB.__del__

(

self

)

def rhessyscalibrator.model_runner_db.ModelRunnerDB.__init__	(		self,
			db_path
	)

Initialize the DB.

Will create a connection to the sqlite DB pointed to by db_path

def rhessyscalibrator.model_runner_db.ModelRunnerDB.__del__

(

self

)

Member Function Documentation

def rhessyscalibrator.model_runner_db.ModelRunnerDB.close

(

self

)

def rhessyscalibrator.model_runner_db.ModelRunnerDB.close

(

self

)

def rhessyscalibrator.model_runner_db.ModelRunnerDB.close

(

self

)

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getMostRecentRunID	(		self,
			session_id
	)

Returns the ID of the run most recently inserted by the given instance of ModelRunnerDB.

Note: if another process has active connections to the underlying sqlite database, the run ID returned will not be the same as the the run ID of the last run inserted by a given instance of ModelRunnerDB, as the other processes may have done in insert into the run table after the most recent insert done by a given instance of ModelRunnerDB.

Parameters

session_id

Integer representing the session associated with this run

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getMostRecentRunID	(		self,
			session_id
	)

Returns the ID of the run most recently inserted by the given instance of ModelRunnerDB.

Note: if another process has active connections to the underlying sqlite database, the run ID returned will not be the same as the the run ID of the last run inserted by a given instance of ModelRunnerDB, as the other processes may have done in insert into the run table after the most recent insert done by a given instance of ModelRunnerDB.

Parameters

session_id

Integer representing the session associated with this run

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getMostRecentRunID	(		self,
			session_id
	)

Returns the ID of the run most recently inserted by the given instance of ModelRunnerDB.

Note: if another process has active connections to the underlying sqlite database, the run ID returned will not be the same as the the run ID of the last run inserted by a given instance of ModelRunnerDB, as the other processes may have done in insert into the run table after the most recent insert done by a given instance of ModelRunnerDB.

Parameters

session_id

Integer representing the session associated with this run

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getMostRecentSessionID

(

self

)

Returns the ID of the session most recently inserted by the given instance of ModelRunnerDB.

Note: if another process has active connections to the underlying sqlite database, the session ID returned will not be the same as the the session ID of the last session inserted by a given instance of ModelRunnerDB, as the other processes may have done in insert into the session table after the most recent insert done by a given instance of ModelRunnerDB.

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getMostRecentSessionID

(

self

)

Returns the ID of the session most recently inserted by the given instance of ModelRunnerDB.

Note: if another process has active connections to the underlying sqlite database, the session ID returned will not be the same as the the session ID of the last session inserted by a given instance of ModelRunnerDB, as the other processes may have done in insert into the session table after the most recent insert done by a given instance of ModelRunnerDB.

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getMostRecentSessionID

(

self

)

Returns the ID of the session most recently inserted by the given instance of ModelRunnerDB.

Note: if another process has active connections to the underlying sqlite database, the session ID returned will not be the same as the the session ID of the last session inserted by a given instance of ModelRunnerDB, as the other processes may have done in insert into the session table after the most recent insert done by a given instance of ModelRunnerDB.

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getRun	(		self,
			run_id
	)

Get the run with the supplied ID.

Parameters

run_id

Integer representing ID of the run to fetch from the DB

Returns

ModelRun object. Returns None if the run_id does not exist

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getRun	(		self,
			run_id
	)

Get the run with the supplied ID.

Parameters

run_id

Integer representing ID of the run to fetch from the DB

Returns

ModelRun object. Returns None if the run_id does not exist

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getRun	(		self,
			run_id
	)

Get the run with the supplied ID.

Parameters

run_id

Integer representing ID of the run to fetch from the DB

Returns

ModelRun object. Returns None if the run_id does not exist

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getRunInSession	(		self,
			session_id,
			job_id
	)

Get all runs associated with a session.

Parameters

session_id	Integer representing the session whose list of runs we want
job_id	String representing job ID of run to retrieve

Returns

ModelRun object

Todo:

Debug and write test case

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getRunInSession	(		self,
			session_id,
			job_id
	)

Get all runs associated with a session.

Parameters

session_id	Integer representing the session whose list of runs we want
job_id	String representing job ID of run to retrieve

Returns

ModelRun object

Todo:

Debug and write test case

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getRunInSession	(		self,
			session_id,
			job_id
	)

Get all runs associated with a session.

Parameters

session_id	Integer representing the session whose list of runs we want
job_id	String representing job ID of run to retrieve

Returns

ModelRun object

Todo:

Debug and write test case

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getRunsInSession	(		self,
			session_id,
			where_clause = None
	)

Get all runs associated with a session.

Parameters

session_id

Integer representing the session whose list of runs we want

Returns

An array of ModelRun objects

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getRunsInSession	(		self,
			session_id,
			where_clause = None
	)

Get all runs associated with a session.

Parameters

session_id

Integer representing the session whose list of runs we want

Returns

An array of ModelRun objects

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getRunsInSession	(		self,
			session_id,
			where_clause = None
	)

Get all runs associated with a session.

Parameters

session_id

Integer representing the session whose list of runs we want

Returns

An array of ModelRun objects

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getRunStatus	(		self,
			id
	)

Gets the status of the given run.

Parameters

id	Integer representing the ID of the run to update

Returns

String representing the the status of the run, One of: PEND, RUN, PUSP, USUSP, SSUSP, DONE, EXIT, UNKWN, WAIT, ZOMBI

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getRunStatus	(		self,
			id
	)

Gets the status of the given run.

Parameters

id	Integer representing the ID of the run to update

Returns

String representing the the status of the run, One of: PEND, RUN, PUSP, USUSP, SSUSP, DONE, EXIT, UNKWN, WAIT, ZOMBI

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getRunStatus	(		self,
			id
	)

Gets the status of the given run.

Parameters

id	Integer representing the ID of the run to update

Returns

String representing the the status of the run, One of: PEND, RUN, PUSP, USUSP, SSUSP, DONE, EXIT, UNKWN, WAIT, ZOMBI

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getSession	(		self,
			session_id
	)

Get the session with the supplied ID.

Parameters

session_id

Integer representing the ID of the session to fetch from the DB

Returns

ModelSession object. Returns None if the session_id does not exist

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getSession	(		self,
			session_id
	)

Get the session with the supplied ID.

Parameters

session_id

Integer representing the ID of the session to fetch from the DB

Returns

ModelSession object. Returns None if the session_id does not exist

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getSession	(		self,
			session_id
	)

Get the session with the supplied ID.

Parameters

session_id

Integer representing the ID of the session to fetch from the DB

Returns

ModelSession object. Returns None if the session_id does not exist

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getSessions

(

self

)

Get all sessions in the DB.

Returns

An array of ModelSession objects

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getSessions

(

self

)

Get all sessions in the DB.

Returns

An array of ModelSession objects

def rhessyscalibrator.model_runner_db.ModelRunnerDB.getSessions

(

self

)

Get all sessions in the DB.

Returns

An array of ModelSession objects

def rhessyscalibrator.model_runner_db.ModelRunnerDB.insertRun	(		self,
			session_id,
			worldfile,
			param_s1,
			param_s2,
			param_s3,
			param_sv1,
			param_sv2,
			param_gw1,
			param_gw2,
			param_vgsen1,
			param_vgsen2,
			param_vgsen3,
			param_svalt1,
			param_svalt2,
			cmd_raw,
			output_path,
			job_id,
			fitness_period = None,
			nse = None,
			nse_log = None,
			pbias = None,
			rsr = None,
			user1 = None,
			user2 = None,
			user3 = None
	)

Creates a new run with a starttime of the current time, and a status of 'PEND'.

Note: you must specify as null (None) any of the param_* arguments that are no used in the run.

Arguments:

Parameters

session_id	Integer representing session to associate this run with
worldfile	String representing name of worldfile associated with this run
s1	Double: decay of hydraulic conductivity with depth (m)
s2	Double: surface hydraulic conductivity (K)
s3	Double: soil depth (OPTIONAL; default=None)
sv1	Double: m to vertical drainage
sv2	Double: K to vertical drainage
gw1	Double: hillslope sat_to_gw_coeff (amount of water moving from saturated to groundwater store)
gw2	Double: hillslope gw_loss_coeff (amount of water moving from groundwater to the stream)
vgsen1	Double: Multiplies specific leaf area (SLA – ratio of leaf area to dry weight)
vgsen2	Double: Multiplies ratio of shaded to sunlit leaf area
vgsen3	Double: changes allocation of net photosynthate based on current LAI (only appl. if using Dickenson C allocation if not using Dickenson, set to 1.0)
svalt1	Double: Multiplies psi air entry pressure
svalt2	Double: Multiplies pore size
cmd_raw	String representing the raw command that invoked this run of RHESSys
output_path	String representing the dir where results for this run are stored
job_id	String representing the job ID associated with this run
fitness_period	String indicating time step over which all fitness results were calculated. One of: daily, monthly, yearly
nse	Double: Nash-Sutcliffe efficiency
nse_log	Double: Nash-Sutcliffe efficiency (log)
pbias	Double: Percent bias
rsr	Double: RMSE / STDEV_obs
user1	Double: User-defined run fitness result
user2	Double: User-defined run fitness result
user3	Double: User-defined run fitness result

Returns

The ID of the run created

def rhessyscalibrator.model_runner_db.ModelRunnerDB.insertRun	(		self,
			session_id,
			worldfile,
			param_s1,
			param_s2,
			param_s3,
			param_sv1,
			param_sv2,
			param_gw1,
			param_gw2,
			param_vgsen1,
			param_vgsen2,
			param_vgsen3,
			param_svalt1,
			param_svalt2,
			cmd_raw,
			output_path,
			job_id,
			fitness_period = None,
			nse = None,
			nse_log = None,
			pbias = None,
			rsr = None,
			user1 = None,
			user2 = None,
			user3 = None
	)

Creates a new run with a starttime of the current time, and a status of 'PEND'.

Note: you must specify as null (None) any of the param_* arguments that are no used in the run.

Arguments:

Parameters

session_id	Integer representing session to associate this run with
worldfile	String representing name of worldfile associated with this run
s1	Double: decay of hydraulic conductivity with depth (m)
s2	Double: surface hydraulic conductivity (K)
s3	Double: soil depth (OPTIONAL; default=None)
sv1	Double: m to vertical drainage
sv2	Double: K to vertical drainage
gw1	Double: hillslope sat_to_gw_coeff (amount of water moving from saturated to groundwater store)
gw2	Double: hillslope gw_loss_coeff (amount of water moving from groundwater to the stream)
vgsen1	Double: Multiplies specific leaf area (SLA – ratio of leaf area to dry weight)
vgsen2	Double: Multiplies ratio of shaded to sunlit leaf area
vgsen3	Double: changes allocation of net photosynthate based on current LAI (only appl. if using Dickenson C allocation if not using Dickenson, set to 1.0)
svalt1	Double: Multiplies psi air entry pressure
svalt2	Double: Multiplies pore size
cmd_raw	String representing the raw command that invoked this run of RHESSys
output_path	String representing the dir where results for this run are stored
job_id	String representing the job ID associated with this run
fitness_period	String indicating time step over which all fitness results were calculated. One of: daily, monthly, yearly
nse	Double: Nash-Sutcliffe efficiency
nse_log	Double: Nash-Sutcliffe efficiency (log)
pbias	Double: Percent bias
rsr	Double: RMSE / STDEV_obs
user1	Double: User-defined run fitness result
user2	Double: User-defined run fitness result
user3	Double: User-defined run fitness result

Returns

The ID of the run created

def rhessyscalibrator.model_runner_db.ModelRunnerDB.insertRun	(		self,
			session_id,
			worldfile,
			param_s1,
			param_s2,
			param_s3,
			param_sv1,
			param_sv2,
			param_gw1,
			param_gw2,
			param_vgsen1,
			param_vgsen2,
			param_vgsen3,
			param_svalt1,
			param_svalt2,
			cmd_raw,
			output_path,
			job_id,
			fitness_period = None,
			nse = None,
			nse_log = None,
			pbias = None,
			rsr = None,
			user1 = None,
			user2 = None,
			user3 = None
	)

Creates a new run with a starttime of the current time, and a status of 'PEND'.

Note: you must specify as null (None) any of the param_* arguments that are no used in the run.

Arguments:

Parameters

session_id	Integer representing session to associate this run with
worldfile	String representing name of worldfile associated with this run
s1	Double: decay of hydraulic conductivity with depth (m)
s2	Double: surface hydraulic conductivity (K)
s3	Double: soil depth (OPTIONAL; default=None)
sv1	Double: m to vertical drainage
sv2	Double: K to vertical drainage
gw1	Double: hillslope sat_to_gw_coeff (amount of water moving from saturated to groundwater store)
gw2	Double: hillslope gw_loss_coeff (amount of water moving from groundwater to the stream)
vgsen1	Double: Multiplies specific leaf area (SLA – ratio of leaf area to dry weight)
vgsen2	Double: Multiplies ratio of shaded to sunlit leaf area
vgsen3	Double: changes allocation of net photosynthate based on current LAI (only appl. if using Dickenson C allocation if not using Dickenson, set to 1.0)
svalt1	Double: Multiplies psi air entry pressure
svalt2	Double: Multiplies pore size
cmd_raw	String representing the raw command that invoked this run of RHESSys
output_path	String representing the dir where results for this run are stored
job_id	String representing the job ID associated with this run
fitness_period	String indicating time step over which all fitness results were calculated. One of: daily, monthly, yearly
nse	Double: Nash-Sutcliffe efficiency
nse_log	Double: Nash-Sutcliffe efficiency (log)
pbias	Double: Percent bias
rsr	Double: RMSE / STDEV_obs
user1	Double: User-defined run fitness result
user2	Double: User-defined run fitness result
user3	Double: User-defined run fitness result

Returns

The ID of the run created

def rhessyscalibrator.model_runner_db.ModelRunnerDB.insertSession	(		self,
			user,
			project,
			notes,
			iterations,
			processes,
			basedir,
			cmd_proto
	)

Creates a new session with a starttime of the current time, and a status of 'submitted'.

Parameters

user	String representing the username of the user who is submitting jobs
project	String representing a short description of the project this modeling session is associated with
notes	String representing a description of the calibraton session
iterations	Integer representing the number of iterations to calibrate each world file
processes	Integer representing the number of simultaneous processes (jobs) to submit
basedir	String representing the basedir where run results are stored
cmd_proto	String representing the command template for running RHESSys

Returns

The ID of the session

def rhessyscalibrator.model_runner_db.ModelRunnerDB.insertSession	(		self,
			user,
			project,
			notes,
			iterations,
			processes,
			basedir,
			cmd_proto
	)

Creates a new session with a starttime of the current time, and a status of 'submitted'.

Parameters

user	String representing the username of the user who is submitting jobs
project	String representing a short description of the project this modeling session is associated with
notes	String representing a description of the calibraton session
iterations	Integer representing the number of iterations to calibrate each world file
processes	Integer representing the number of simultaneous processes (jobs) to submit
basedir	String representing the basedir where run results are stored
cmd_proto	String representing the command template for running RHESSys

Returns

The ID of the session

def rhessyscalibrator.model_runner_db.ModelRunnerDB.insertSession	(		self,
			user,
			project,
			notes,
			iterations,
			processes,
			basedir,
			cmd_proto
	)

Creates a new session with a starttime of the current time, and a status of 'submitted'.

Parameters

user	String representing the username of the user who is submitting jobs
project	String representing a short description of the project this modeling session is associated with
notes	String representing a description of the calibraton session
iterations	Integer representing the number of iterations to calibrate each world file
processes	Integer representing the number of simultaneous processes (jobs) to submit
basedir	String representing the basedir where run results are stored
cmd_proto	String representing the command template for running RHESSys

Returns

The ID of the session

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateRunEndtime	(		self,
			id,
			endtime,
			status
	)

Updates the end time and the status of the given run.

Parameters

id	Integer representing the ID of the run to update
endtime	datetime representing the end time of the run (in UTC not local time)
status	String: one of: PEND, RUN, PUSP, USUSP, SSUSP, DONE, EXIT, UNKWN, WAIT, ZOMBI

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateRunEndtime	(		self,
			id,
			endtime,
			status
	)

Updates the end time and the status of the given run.

Parameters

id	Integer representing the ID of the run to update
endtime	datetime representing the end time of the run (in UTC not local time)
status	String: one of: PEND, RUN, PUSP, USUSP, SSUSP, DONE, EXIT, UNKWN, WAIT, ZOMBI

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateRunEndtime	(		self,
			id,
			endtime,
			status
	)

Updates the end time and the status of the given run.

Parameters

id	Integer representing the ID of the run to update
endtime	datetime representing the end time of the run (in UTC not local time)
status	String: one of: PEND, RUN, PUSP, USUSP, SSUSP, DONE, EXIT, UNKWN, WAIT, ZOMBI

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateRunFitnessResults	(		self,
			id,
			fitness_period,
			nse,
			nse_log,
			pbias = None,
			rsr = None,
			user1 = None,
			user2 = None,
			user3 = None
	)

Updates fitness results of a model run.

Parameters

id	Integer representing The ID of the run to update
fitness_period	String indicating time step over which all fitness results were calculated. One of: daily, monthly, yearly
nse	Double: Nash-Sutcliffe efficiency
nse_log	Double: Nash-Sutcliffe efficiency (log)
pbias	Double: Percent bias
rsr	Double: RMSE / STDEV_obs
user1	Double: User-defined run fitness result
user2	Double: User-defined run fitness result
user3	Double: User-defined run fitness result

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateRunFitnessResults	(		self,
			id,
			fitness_period,
			nse,
			nse_log,
			pbias = None,
			rsr = None,
			user1 = None,
			user2 = None,
			user3 = None
	)

Updates fitness results of a model run.

Parameters

id	Integer representing The ID of the run to update
fitness_period	String indicating time step over which all fitness results were calculated. One of: daily, monthly, yearly
nse	Double: Nash-Sutcliffe efficiency
nse_log	Double: Nash-Sutcliffe efficiency (log)
pbias	Double: Percent bias
rsr	Double: RMSE / STDEV_obs
user1	Double: User-defined run fitness result
user2	Double: User-defined run fitness result
user3	Double: User-defined run fitness result

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateRunFitnessResults	(		self,
			id,
			fitness_period,
			nse,
			nse_log,
			pbias = None,
			rsr = None,
			user1 = None,
			user2 = None,
			user3 = None
	)

Updates fitness results of a model run.

Parameters

id	Integer representing The ID of the run to update
fitness_period	String indicating time step over which all fitness results were calculated. One of: daily, monthly, yearly
nse	Double: Nash-Sutcliffe efficiency
nse_log	Double: Nash-Sutcliffe efficiency (log)
pbias	Double: Percent bias
rsr	Double: RMSE / STDEV_obs
user1	Double: User-defined run fitness result
user2	Double: User-defined run fitness result
user3	Double: User-defined run fitness result

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateRunJobId	(		self,
			id,
			job_id
	)

Updates the job_id of the given run.

Parameters

id	Integer representing the ID of the run to update
job_id	String representing the job ID of the run

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateRunJobId	(		self,
			id,
			job_id
	)

Updates the job_id of the given run.

Parameters

id	Integer representing the ID of the run to update
job_id	String representing the job ID of the run

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateRunJobId	(		self,
			id,
			job_id
	)

Updates the job_id of the given run.

Parameters

id	Integer representing the ID of the run to update
job_id	String representing the job ID of the run

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateRunStatus	(		self,
			id,
			status,
			endtime = None
	)

Updates the status of the given run.

If endtime is not None, will update endtime as well as status

Parameters

id	Integer representing the ID of the run to update
status	String: one of: PEND, RUN, PUSP, USUSP, SSUSP, DONE, EXIT, UNKWN, WAIT, ZOMBI
endtime	datetime representing the end time of the run (in UTC not local time)

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateRunStatus	(		self,
			id,
			status,
			endtime = None
	)

Updates the status of the given run.

If endtime is not None, will update endtime as well as status

Parameters

id	Integer representing the ID of the run to update
status	String: one of: PEND, RUN, PUSP, USUSP, SSUSP, DONE, EXIT, UNKWN, WAIT, ZOMBI
endtime	datetime representing the end time of the run (in UTC not local time)

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateRunStatus	(		self,
			id,
			status,
			endtime = None
	)

Updates the status of the given run.

If endtime is not None, will update endtime as well as status

Parameters

id	Integer representing the ID of the run to update
status	String: one of: PEND, RUN, PUSP, USUSP, SSUSP, DONE, EXIT, UNKWN, WAIT, ZOMBI
endtime	datetime representing the end time of the run (in UTC not local time)

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateSessionEndtime	(		self,
			id,
			endtime,
			status
	)

Updates the end time and the status of the given session.

Parameters

id	Integer representing the ID of the session to update
endtime	datetime representing the end time of the session (in UTC not local time)
status	String: one of: submitted, complete, aborted

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateSessionEndtime	(		self,
			id,
			endtime,
			status
	)

Updates the end time and the status of the given session.

Parameters

id	Integer representing the ID of the session to update
endtime	datetime representing the end time of the session (in UTC not local time)
status	String: one of: submitted, complete, aborted

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateSessionEndtime	(		self,
			id,
			endtime,
			status
	)

Updates the end time and the status of the given session.

Parameters

id	Integer representing the ID of the session to update
endtime	datetime representing the end time of the session (in UTC not local time)
status	String: one of: submitted, complete, aborted

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateSessionObservationFilename	(		self,
			id,
			obs_filename
	)

Updates the obs_filename used for calculating model fitness statistics for runs associated with the session.

Parameters

id	Integer representing the ID of the session to update
obs_filename	String representing the name of the observation file used to calculate fitness statistics for model runs

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateSessionObservationFilename	(		self,
			id,
			obs_filename
	)

Updates the obs_filename used for calculating model fitness statistics for runs associated with the session.

Parameters

id	Integer representing the ID of the session to update
obs_filename	String representing the name of the observation file used to calculate fitness statistics for model runs

def rhessyscalibrator.model_runner_db.ModelRunnerDB.updateSessionObservationFilename	(		self,
			id,
			obs_filename
	)

Updates the obs_filename used for calculating model fitness statistics for runs associated with the session.

Parameters

id	Integer representing the ID of the session to update
obs_filename	String representing the name of the observation file used to calculate fitness statistics for model runs

---

The documentation for this class was generated from the following file:

• build/lib/rhessyscalibrator/model_runner_db.py