API reference for core modules#
The core module contains the key shared resources and
building blocks used to develop the different component models of the Virtual Ecosystem
and then to configure them, populate them with data and provide logging.
Each of the core sub-modules has its own API reference page:
The
config_buildersubmodule covers the parsing and compilation of TOML configuration documents.The
configurationsubmodule provides tools to validate loaded configuration documents and return configuration class objects.The
loggerconfigures theLoggerinstance used throughout the package.The
gridsubmodule covers the definition of the spatial layout to be used in a simulation and provides an interface to the spatial relationships between cells.The
datasubmodule provides the central data object used to store data required by the simulation and methods to populate that data object for use in simulations.The
readerssubmodule provides functionality to read external data files into a standard internal format.The
axessubmodule provides validation for data to ensure that it is congruent with the model configuration.The
base_modelsubmodule provides an Abstract Base Class describing the shared API to be used by science models within the Virtual Ecosystem.The
model_configmodule contains the core module configuration and constants that are shared across multiple models.The
utilscontains the utility functions that are used across the Virtual Ecosystem.The
exceptionssubmodule defines custom exceptions that are used either in the core module, or across multiple modules.The
docutilssubmodule defines functionality for aesthetically pleasing displays of the model content in the documentation.
The core module itself is only responsible for loading the
configuration schema for the core submodules.