The high-level API is principally defined in
Preprocessor classes and API¶
Command line preprocessor.
Python high level api.
Base preprocessor class.
Preprocessor function and utilities¶
Wrapper for CLI interface.
The entry_points setup of a command line interface requires a function, so we use this simple wrapper to instantiate and run the jobs.
Write a config to file in output folder.
Write the entire yaml configuation for the configured job out to a file in the job output foler.
This fuinction is utilized by the BMI implementation of pyDeltaRCM as well.
Scale a relative sea level rise rate to model time.
This function scales any relative sea level rise rate (RSLR) (e.g., sea level rise, subsidence) to a rate appropriate for the model time. This is helpful, because most discussion of RSLR uses units of mm/yr, but the model (and model configuration) require units of m/s. Additionally, the model framework needs to assume an “intermittency factor” to convert from real-world time to model time.
Relative sea level rise (subsidence and/or sea level rise) are scaled from real world dimensions of mm/yr to model input as:
This conversion makes it such that when one real-world year has elapsed ( seconds in model time), the relative sea level has changed by the number of millimeters specified in the input
Users should use this function to determine the value to specify in an input YAML configuration file; no scaling is performed internally.
float) – Millimeters per year, relative sea level rise rate.
float, optional) – Intermittency factor, fraction of time represented by morphodynamic activity. Should be in interval (0, 1). Defaults to 1 if not provided, i.e., no scaling is performed.
scaled – Scaled relative sea level rise rate, in meters per second.
- Return type