proteuslib.edb package
Submodules
proteuslib.edb.commands module
Commands for Electrolyte Database
proteuslib.edb.data_model module
Data model for electrolyte database.
Usage to get configuration for IDAES:
base = <query database for Base config of interest>
c_list = <get Components from database>
# add all the components to the base
for c in c_list:
base.add(c)
# get the merged configuration for IDAES functions
config = base.idaes_config
Class diagram:
┌────────────────────────────────┐
│ ConfigGenerator <<abstract>> │
uses ├────────────────────────────────┤
┌─────►│+ConfigGenerator(data) │
│ │ │
│ ├────────────────────────────────┤
│ │+config │
│ │_transform(data) │
│ └────────────┬───────────────────┘
│ │
│ ├───────────┬───────────────────────┐
│ │ │ │
│ ┌──────────────┴┐ ┌──┴──────────┐ ┌─────┴─────┐
│ │ ReactionConfig│ │ ThermoConfig│ │ BaseConfig│
│ └─────▲─────────┘ └─▲───────────┘ └───────▲───┘
│ │ │ │
│ │ │ │
│ │ │ │
│ │uses │uses │uses
│ │ │ │
│ │ │ │
│ ┌───────┼───────────────────┼──────────────────────────┼────────────┐
│ │ │ │ │ │
│ │ ┌────┴─────┐ ┌─────────┴───┐ ┌─────────────────┴─────────┐ │
│ │ │ Reaction │ │ Component │ │ Base │ │
│ │ └─────┬────┘ └──────┬──────┘ │ │ │
│ │ │ │ │ +add(item:DataWrapper) │ │
│ │ │ │ └─────────┬─────────────────┘ │
│ │ │ │ │ │
│ │ │ │ │ │
│ │ ├───────────────┴─────────────────────┘ │
│ │ │ │
│ │ │ │
│ └────────┼──────────────────────────────────────────────────┬───────┘
│ │ │
│ │ │
│ │ ┌────────┴─────────────┐
│ │ subclass │ │
│ ┌───────▼────────────────────────────┐ │ Public interface to │
│ │DataWrapper <<abstract>> │ │ the rest of │
│ ├────────────────────────────────────┤ │ ProteusLib │
│ │+DataWrapper(data, config_gen_class)│ │ │
└───┼────────────────────────────────────┤ └──────────────────────┘
│+idaes_config: dict │
│+merge_keys: tuple[str] │
└────────────────────────────────────┘
- class proteuslib.edb.data_model.Base(data: Dict)[source]
Bases:
DataWrapper
Wrapper for ‘base’ information to which a component or reaction is added.
- add(item: DataWrapper)[source]
Add wrapped data to this base object.
- property idaes_config
“Get the data as an IDAES config dict.
- Returns
Python dict that can be passed to the IDAES as a config.
- class proteuslib.edb.data_model.BaseConfig(data: Dict, name=None)[source]
Bases:
ConfigGenerator
- class proteuslib.edb.data_model.Component(data: Dict, validation=True)[source]
Bases:
DataWrapper
- class proteuslib.edb.data_model.ConfigGenerator(data: Dict, name=None)[source]
Bases:
object
Interface for getting an IDAES ‘idaes_config’ dict.
- class proteuslib.edb.data_model.DataWrapper(data: Dict, config_gen_class: Optional[Type[ConfigGenerator]] = None, validate_as_type=None)[source]
Bases:
object
Interface to wrap data from DB in convenient ways for consumption by the rest of the library.
Do not use this class directly.
Derived classes will feed the data (from the database) and the appropriate subclass of GenerateConfig to the constructor. Then the IDAES config will be available from the idaes_config attribute. Note that no conversion work is done before the first access, and the converted result is cached to avoid extra work on repeated accesses.
- classmethod from_idaes_config(config: Dict) List[DataWrapper] [source]
The inverse of the idaes_config property, this method constructs a new instance of the wrapped data from the IDAES config information.
- Parameters
config – Valid IDAES configuration dictionary
- Raises
BadConfiguration – If the configuration can’t be transformed into the EDB form due to missing/invalid fields.
- property idaes_config: Dict
“Get the data as an IDAES config dict.
- Returns
Python dict that can be passed to the IDAES as a config.
- property json_data: Dict
Get the data in its “natural” form as a dict that can be serialized to JSON.
- set_parameter(key: str, value, units: str = 'dimensionless', index=0)[source]
Add to existing parameters or create a new parameter value.
- Parameters
key – Name of parameter
value – New value
units – Units for value
index – If parameter is a list of values, index to set. Otherwise. a list of length of 1 will be created with an index of 0.
- Returns
None
- Raises
KeyError – If the data structure doesn’t have a spot for parameters. This is likely a more basic problem with the current instance.
- class proteuslib.edb.data_model.Reaction(data: Dict, validation=True)[source]
Bases:
DataWrapper
- classmethod from_idaes_config(config: Dict) List[Reaction] [source]
See documentation on parent class.
- set_reaction_order(phase: str, lhs: List[str], rhs: List[str], lhs_value: int = 0, rhs_value: int = 1) Dict [source]
Set the reaction order (if it differs from stoichiometry).
- Parameters
phase – ‘Liq’ or ‘Vap’
lhs – Left-hand side of equation components
rhs – Right-hand side of equation components
lhs_value – Integer value for LHS components
rhs_value – Integer value for RHS components
- Returns
Reaction order for all phases, which can be modified further in-place
- Raises
KeyError – something is missing in the data structure
- class proteuslib.edb.data_model.ReactionConfig(data, name='unknown', validation=True)[source]
Bases:
ConfigGenerator
- class proteuslib.edb.data_model.Result(iterator=None, item_class=None)[source]
Bases:
object
Encapsulate one or more JSON objects in the appropriate
DataWrapper
subclass.Users won’t need to instantiate this directly, just iterate over it to retrieve the result of a database query or other operation that returns EDB data objects.
For example:
result = db.get_reactions(..search-params...) for reaction_obj in result: # ..work with instance of class Reaction.. print(reaction_obj.name)
- class proteuslib.edb.data_model.ThermoConfig(data, name='unknown', validation=True)[source]
Bases:
ConfigGenerator
proteuslib.edb.db_api module
Database operations API
- class proteuslib.edb.db_api.ElectrolyteDB(url='mongodb://localhost:27017', db='electrolytedb')[source]
Bases:
object
Interface to the Electrolyte database.
This uses MongoDB as the underlying data store.
- static drop_database(url, db)[source]
Drop a database.
- Parameters
url – MongoDB server URL
db – Database name
- Returns
None
- Raises
anything pymongo.MongoClient() can raise –
- get_components(component_names: Optional[List[str]] = None, element_names: Optional[List[str]] = None) Result [source]
Get thermodynamic information for components of reactions.
- Parameters
component_names – List of component names
element_names – List of element names (ignored if component_names is given)
- Returns
All components matching the criteria (or all if none specified)
- get_reactions(component_names: Optional[List] = None, phases: Optional[Union[List[str], str]] = None, any_components: bool = False, reaction_names: Optional[List] = None) Result [source]
Get reaction information.
- Parameters
component_names – List of component names
phases – Phase(s) to include; if not given allow any. Currently implemented only when any_components is False.
any_components – If False, the default, only return reactions where one side of the reaction has all components provided. If true, return the (potentially larger) set of reactions where any of the components listed are present.
reaction_names – List of reaction names instead of component names
- Returns
All reactions containing any of the names (or all reactions, if not specified)
- load(data: Union[Dict, List[Dict], DataWrapper, List[DataWrapper]], rec_type: str = 'base') int [source]
Load a single record or list of records.
- Parameters
data – Data to load, as a single or list of dictionaries or
DataWrapper
subclassrec_type – If input is a dict, the type of record. This argument is ignored if the input is a subclass of DataWrapper.
- Returns
Number of records loaded
proteuslib.edb.error module
Error classes and utilities for the electrolyte database (EDB).
- exception proteuslib.edb.error.BadConfiguration(whoami: str, config: Dict, missing: Optional[str] = None, why: Optional[str] = None)[source]
Bases:
DataWrapperError
Bad configuration provided to build a DataWrapper class.
- exception proteuslib.edb.error.ConfigGeneratorError[source]
Bases:
Error
Base class of errors for ConfigGenerator actions and effects.
- exception proteuslib.edb.error.DataWrapperError[source]
Bases:
Error
“Base class of errors for DataWrapper actions and effects.
proteuslib.edb.schemas module
- JSON schema embedded as variables for:
component
reaction
proteuslib.edb.validate module
Validate input for electrolyte database.
- proteuslib.edb.validate.validate(obj: Union[Dict, TextIO, Path, str, DataWrapper], obj_type='')[source]
Validate an input.
- Parameters
obj – Input data, file, path, or DataWrapper to validate.
obj_type – Either ‘component’ or ‘reaction’. Ignored for DataWrapper inputs.
- Raises
TypeError – If ‘obj’ is not an acceptable type of object
ValueError – If the ‘obj_type’ is not valid
ValidationError – If validation fails
Module contents
Electrolyte database.
Design:
┌────────────────────────────┐
│ Validate │
│ ┌───────┐ ┌──────┐ │
│ │JSON │ │JSON │ │
│ │input │ │schema│ │
│ │data │ │ │ │
│ └───────┴┐ ┌─┴──────┘ │
│ │ │ │
│ ┌──▼─▼───┐ │
│ │ │NO │
│ │ VALID? ├───►Error │
│ └────┬───┘ │
│ │ │
│ │YES │
└─────────────┼──────────────┘
│ ┌───────────────┐
DB API........│..... │ reaction │
... ┌───▼───┐ .. ;;;;;;;; ├───────────────┤
.. │Load ├──.───►; ; │ component │
.. └───────┘ . ; DB ;───┼───────────────┤
. ▲ .. ; ; │ base │
.. │ . ;;;;;;;; ├───────────────┤
. │ ... └───────────────┘
. │ ... ...........................
. ┌───────▼┐ ┌─────────┐... ...──────────┐ ┌───────────...
. │ Search ├───►│ Fetch │ . .. │ Component◄──o│ HasConfig │ .
.. └────────┘ └────┬────┘ . .. └──────▲───┘ └───o───────┘ .
... │ . .. │ │ .
... │ ... . │ │ ..
..... │ ... .. ┌───────x───┐ │ .
. ... .. .│... . │ Reaction │◄──────┘ ..
│ . └─────▲─────┘ .
│ . │ ..
│ . **┌─────x───┐ ..
└─────────.──►│ Result │ Data model
... └─────────┘ ..
..... ....
............ ...