Landlab Framework

Submodules

landlab.framework.component module

Utility functions for loading components for The Landlab.

iscomponent(value, cls)

Check if value is a component for The Landlab. value is a component if it implements the cls or it is an instance of cls.

Returns True if value is a component, otherwise False.

load_components(cls, paths=None)

Load components from a series of directories.

Components found earlier in the search path order override those discovered later. Use the paths keyword to specify a list of paths to search for components.

See also

load_components_from_dir

load_components_from_dir(path, cls)

Look for components for Landlab in path.

Identify components as being an instance of cls. Returns a dictionary of discovered component names as keys and component classes as values.

load_landlab_components(paths=None)

Load components for The Landlab. These are classes that implement BmiBase. See load_components_from_dir for the meaning of paths keyword.

See also

load_components_from_dir

landlab.framework.decorators module

Decorators for TheLandlab package.

camel_case(text, sep=None)

Convert to camel case.

Convert text to camel case. Use the sep keyword to specify the word separator. The default is to split on whitespace.

>>> from landlab.framework.decorators import camel_case
>>> camel_case("eric idle")
'EricIdle'
>>> camel_case("terry_gilliam", sep="_")
'TerryGilliam'
>>> camel_case("MONTY Python")
'MONTYPython'
>>> camel_case("GrahamChapman")
'GrahamChapman'

snake_case(text)

Convert camel case to snake case.

Examples

>>> from landlab.framework.decorators import snake_case
>>> snake_case("EricIdle")
'eric_idle'
>>> snake_case("MONTYPython")
'monty_python'

landlab.framework.interfaces module

The Basic Modeling Interface.

exception BadVarNameError(name)

Bases: Error

Exception to indicate a bad input/output variable name.

class BmiBase

Bases: object

Definition of the Basic Modeling Interface.

finalize()

Clean-up model.

get_current_time()

Current time of model.

get_end_time()

Model stop time.

get_input_var_names()

Get names of input variables to the model as standard names.

Returns:

A list of input standard names as strings

get_output_var_names()

Get names of output variables to the model as standard names.

Returns:

A list of output standard names as strings

get_start_time()

Model start time.

get_time_step()

Model time step.

get_var_rank(var_name)

Rank of exchange item.

get_var_type(var_name)

Get type of an exchange item.

get_var_units(var_name)

Get units of an exchange item.

initialize(file_name)

Initialize model.

File_name:

String of configuration file

update(**kwds)

Update model by one time step.

class BmiExtendedBase

Bases: object

An extension interface for a BMI.

run_model()

Initialize, run, and finalize a model.

update_until(time)

Update model until some time.

Time:

Update duration

class BmiGridType(code, name)

Bases: int

Base type to indicate the type of a BMI model’s grid.

Code:

Grid type code as an int

Name:

Name of the grid type as a string

class BmiNoGrid

Bases: object

BMI for a model that does not have a grid.

class BmiRectilinear

Bases: object

BMI for a model that uses a rectilinear grid.

get_columns(name)

Get coordinates of grid columns.

get_grid_shape(name)

Get shape of grid for variable, name.

Name:

Standard name

get_rows(name)

Get coordinates of grid rows.

class BmiStructured

Bases: object

BMI for a model that uses a structured grid.

get_grid_shape(name)

Get shape of grid for variable, name.

Name:

Standard name

get_x(name)

Get x-coordinates of grid nodes.

get_y(name)

Get y-coordinates of grid nodes.

class BmiUniformRectilinear

Bases: object

BMI for a model that exposes a uniform rectilinear grid.

get_grid_origin(name)

Get origin of grid for variable, name.

Name:

Standard name

get_grid_shape(name)

Get shape of grid for variable, name.

Name:

Standard name

get_grid_spacing(name)

Get spacing of grid for variable, name.

Name:

Standard name

class BmiUnstructured

Bases: object

BMI for a model that uses an unstructured grid.

get_connectivity(name)

Get cell connectivity.

get_offset(name)

Get cell offset.

get_x(name)

Get x-coordinates of grid nodes.

get_y(name)

Get y-coordinates of grid nodes.

exception Error

Bases: Exception

Base class for BMI exceptions.

exception FatalError

Bases: Exception

Raise this exception if an unrecoverable error was found.

exception MissingModelAttributeError(attrib)

Bases: Error

Raise this exception if a component is missing a required attribute.

exception TimeBoundsError

Bases: Error

Raise this exception if a component updates beyond its time horizon.

Module contents

The Landlab modeling framework.