mirror of https://github.com/ANL-CEEESA/LLEPE
parent
71ff751a65
commit
578aeb6f03
@ -0,0 +1,52 @@
|
||||
/* Main colors from https://color.adobe.com/fr/Copy-of-NOUEBO-Original-color-theme-11116609 */
|
||||
:root{
|
||||
--main-bg-color: #324D5C;
|
||||
--link-color: #14B278;
|
||||
}
|
||||
|
||||
/* Header fonts y */
|
||||
h1, h2, .rst-content .toctree-wrapper p.caption, h3, h4, h5, h6, legend, p.caption {
|
||||
font-family: "Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;
|
||||
}
|
||||
|
||||
|
||||
/* Docs background */
|
||||
.wy-side-nav-search{
|
||||
background-color: var(--main-bg-color);
|
||||
}
|
||||
|
||||
/* Mobile version */
|
||||
.wy-nav-top{
|
||||
background-color: var(--main-bg-color);
|
||||
}
|
||||
|
||||
/* Change link colors (except for the menu) */
|
||||
a {
|
||||
color: var(--link-color);
|
||||
}
|
||||
|
||||
a:hover {
|
||||
color: #4F778F;
|
||||
}
|
||||
|
||||
.wy-menu a {
|
||||
color: #b3b3b3;
|
||||
}
|
||||
|
||||
.wy-menu a:hover {
|
||||
color: #b3b3b3;
|
||||
}
|
||||
|
||||
a.icon.icon-home {
|
||||
color: #b3b3b3;
|
||||
}
|
||||
|
||||
.version{
|
||||
color: var(--link-color) !important;
|
||||
}
|
||||
|
||||
|
||||
/* Make code blocks have a background */
|
||||
.codeblock,pre.literal-block,.rst-content .literal-block,.rst-content pre.literal-block,div[class^='highlight'] {
|
||||
background: #f8f8f8;;
|
||||
}
|
After Width: | Height: | Size: 27 KiB |
After Width: | Height: | Size: 32 KiB |
@ -0,0 +1,70 @@
|
||||
# Configuration file for the Sphinx documentation builder.
|
||||
#
|
||||
# This file only contains a selection of the most common options. For a full
|
||||
# list see the documentation:
|
||||
# https://www.sphinx-doc.org/en/master/usage/configuration.html
|
||||
|
||||
# -- Path setup --------------------------------------------------------------
|
||||
|
||||
# If extensions (or modules to document with autodoc) are in another directory,
|
||||
# add these directories to sys.path here. If the directory is relative to the
|
||||
# documentation root, use os.path.abspath to make it absolute, like shown here.
|
||||
#
|
||||
import os
|
||||
import sys
|
||||
|
||||
sys.path.insert(0, os.path.abspath('../../'))
|
||||
|
||||
# -- Project information -----------------------------------------------------
|
||||
|
||||
project = 'LLEPE'
|
||||
copyright = '2020, Titus Quah, Nwike Iloeje'
|
||||
author = 'Titus Quah, Nwike Iloeje'
|
||||
master_doc = 'index'
|
||||
|
||||
# The full version, including alpha/beta/rc tags
|
||||
release = '1.0.0'
|
||||
|
||||
# -- General configuration ---------------------------------------------------
|
||||
|
||||
# Add any Sphinx extension module names here, as strings. They can be
|
||||
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
|
||||
# ones.
|
||||
|
||||
import sphinx_rtd_theme
|
||||
|
||||
extensions = ["sphinx_rtd_theme",
|
||||
'sphinx.ext.autodoc',
|
||||
'sphinx.ext.autosummary',
|
||||
'sphinx.ext.mathjax',
|
||||
'sphinx.ext.ifconfig',
|
||||
'sphinx.ext.viewcode',
|
||||
]
|
||||
|
||||
# Add any paths that contain templates here, relative to this directory.
|
||||
templates_path = ['_templates']
|
||||
|
||||
# The language for content autogenerated by Sphinx. Refer to documentation
|
||||
# for a list of supported languages.
|
||||
#
|
||||
# This is also used if you do content translation via gettext catalogs.
|
||||
# Usually you set "language" from the command line for these cases.
|
||||
language = 'python'
|
||||
|
||||
# List of patterns, relative to source directory, that match files and
|
||||
# directories to ignore when looking for source files.
|
||||
# This pattern also affects html_static_path and html_extra_path.
|
||||
exclude_patterns = []
|
||||
|
||||
# -- Options for HTML output -------------------------------------------------
|
||||
|
||||
# The theme to use for HTML and HTML Help pages. See the documentation for
|
||||
# a list of builtin themes.
|
||||
#
|
||||
html_theme = "sphinx_rtd_theme"
|
||||
html_logo = '_static/img/logo.png'
|
||||
|
||||
# Add any paths that contain custom static files (such as style sheets) here,
|
||||
# relative to this directory. They are copied after the builtin static files,
|
||||
# so a file named "default.css" will overwrite the builtin "default.css".
|
||||
html_static_path = ['_static']
|
@ -0,0 +1,44 @@
|
||||
.. _install:
|
||||
|
||||
************
|
||||
Installation
|
||||
************
|
||||
|
||||
|
||||
Prerequisites
|
||||
=============
|
||||
|
||||
LLEPE requires python3 (>=3.5) with the development headers.
|
||||
|
||||
|
||||
Stable Release
|
||||
==============
|
||||
|
||||
There is currently no stable release
|
||||
|
||||
|
||||
Bleeding-edge version
|
||||
=====================
|
||||
|
||||
To install the latest master version:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
pip install git+https://xgitlab.cels.anl.gov/summer-2020/parameter-estimation.git
|
||||
|
||||
|
||||
Development version
|
||||
===================
|
||||
|
||||
To contribute to Stable-Baselines, with support for running tests and building the documentation.
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
git clone https://xgitlab.cels.anl.gov/summer-2020/parameter-estimation.git && cd parameter-estimation
|
||||
pip install -e .[docs,tests]
|
||||
|
||||
|
||||
Using Docker Images
|
||||
===================
|
||||
|
||||
Not set up yet.
|
@ -0,0 +1,49 @@
|
||||
.. _quickstart:
|
||||
|
||||
***************
|
||||
Getting Started
|
||||
***************
|
||||
|
||||
Here is a quick example of how to fit an xml thermodynamic model to experimental data.
|
||||
|
||||
This code fits Nd standard enthalpy in the "twophase.xml" cantera file to the
|
||||
experimental data in "Nd_exp_data.csv".
|
||||
|
||||
This code requires that you copy and paste the "elementz.xml" file in the llepe's data folder into
|
||||
the Cantera's data folder located in your environments site-packages folder.
|
||||
|
||||
The code then produces a parity plot of the measured and predicted concentrations of Nd 3+ in the
|
||||
aqueous phase.
|
||||
|
||||
.. code-block:: python
|
||||
|
||||
from llepe import LLEPE
|
||||
opt_dict = {'Nd(H(A)2)3(org)_h0': {'upper_element_name': 'species',
|
||||
'upper_attrib_name': 'name',
|
||||
'upper_attrib_value': 'Nd(H(A)2)3(org)',
|
||||
'lower_element_name': 'h0',
|
||||
'lower_attrib_name': None,
|
||||
'lower_attrib_value': None,
|
||||
'input_format': '{0}',
|
||||
'input_value': -4.7e6}}
|
||||
|
||||
searcher_parameters = {'exp_data': 'Nd_exp_data.csv',
|
||||
'phases_xml_filename': 'twophase.xml',
|
||||
'opt_dict': opt_dict,
|
||||
'phase_names': ['HCl_electrolyte', 'PC88A_liquid'],
|
||||
'aq_solvent_name': 'H2O(L)',
|
||||
'extractant_name': '(HA)2(org)',
|
||||
'diluant_name': 'dodecane',
|
||||
'complex_names': ['Nd(H(A)2)3(org)'],
|
||||
'extracted_species_ion_names': ['Nd+++'],
|
||||
'aq_solvent_rho': 1000.0,
|
||||
'extractant_rho': 960.0,
|
||||
'diluant_rho': 750.0}
|
||||
searcher = LLEPE(**searcher_parameters)
|
||||
est_enthalpy = searcher.fit()
|
||||
searcher.update_xml(est_enthalpy)
|
||||
searcher.parity_plot(print_r_squared=True)
|
||||
|
||||
The code should return something like this
|
||||
|
||||
.. figure:: ../_static/img/quick_start_output.png
|
@ -0,0 +1,38 @@
|
||||
.. reeps documentation master file, created by Titus Quah
|
||||
sphinx-quickstart on Tue Jun 9 10:13:23 2020.
|
||||
You can adapt this file completely to your liking, but it should at least
|
||||
contain the root `toctree` directive.
|
||||
|
||||
Welcome to llepe's docs! - the Liquid-Liquid Extraction Parameter Estimator
|
||||
===========================================================================
|
||||
LLEPE is a package for thermodynamic parameter estimation for liquid-liquid extraction modeling
|
||||
|
||||
LLEPE takes experimental data in a csv and system data in a xml.
|
||||
|
||||
The package then uses Cantera, another python package, to simulate equilibrium.
|
||||
|
||||
Error between predicted and experimental data is then minimized.
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
:caption: User Guide
|
||||
|
||||
guide/install
|
||||
guide/quickstart
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:caption: Searchers
|
||||
|
||||
modules/reeps
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Indices and tables
|
||||
==================
|
||||
|
||||
* :ref:`genindex`
|
||||
* :ref:`modindex`
|
||||
* :ref:`search`
|
@ -0,0 +1,15 @@
|
||||
.. _reeps:
|
||||
|
||||
.. automodule:: llepe
|
||||
|
||||
LLEPE
|
||||
=====
|
||||
|
||||
|
||||
|
||||
Parameters
|
||||
----------
|
||||
|
||||
.. autoclass:: LLEPE
|
||||
:members:
|
||||
:inherited-members:
|
Loading…
Reference in new issue