#858 merge develop

Author: martinjrobins

.gitignore

@@ -36,6 +36,9 @@ input/*
 !input/comsol_results/
 !input/drive_cycles
 
+# keep images required by notebooks
+!examples/notebooks/Creating%20Models/SEI.png
+
 # simulation outputs
 out/
 config.py
@@ -59,6 +62,7 @@ htmlcov/
 pyproject.toml
 
 # virtual enviroment
+env/
 venv/
 venv3.5/
 PyBaMM-env/

CHANGELOG.md

@@ -1,3 +1,25 @@
+# [Unreleased](https://github.com/pybamm-team/PyBaMM)
+
+## Features
+
+-   Added additional notebooks showing how to create and compare models ([#877](https://github.com/pybamm-team/PyBaMM/pull/877))
+-   Added `Minimum`, `Maximum` and `Sign` operators ([#876](https://github.com/pybamm-team/PyBaMM/pull/876))
+-   Added a search feature to `FuzzyDict` ([#875](https://github.com/pybamm-team/PyBaMM/pull/875))
+-   Add ambient temperature as a function of time ([#872](https://github.com/pybamm-team/PyBaMM/pull/872))
+-   Added `CasadiAlgebraicSolver` for solving algebraic systems with CasADi ([#868](https://github.com/pybamm-team/PyBaMM/pull/868))
+-   Added electrolyte functions from Landesfeind ([#860](https://github.com/pybamm-team/PyBaMM/pull/860))
+
+## Bug fixes
+
+-   Reformatted external circuit submodels ([#879](https://github.com/pybamm-team/PyBaMM/pull/879))
+-   Some bug fixes to generalize specifying models that aren't battery models, see [#846](https://github.com/pybamm-team/PyBaMM/issues/846)
+-   Reformatted interface submodels to be more readable ([#866](https://github.com/pybamm-team/PyBaMM/pull/866))
+-   Removed double-counted "number of electrodes connected in parallel" from simulation ([#864](https://github.com/pybamm-team/PyBaMM/pull/864))
+
+## Breaking changes
+
+-   Removed "set external temperature" and "set external potential" options. Use "external submodels" option instead ([#862](https://github.com/pybamm-team/PyBaMM/pull/862))
+
 # [v0.2.0](https://github.com/pybamm-team/PyBaMM/tree/v0.2.0) - 2020-02-26
 
 This release introduces many new features and optimizations. All models can now be solved using the pip installation - in particular, the DFN can be solved in around 0.1s. Other highlights include an improved user interface, simulations of experimental protocols (GITT, CCCV, etc), new parameter sets for NCA and LGM50, drive cycles, "input parameters" and "external variables" for quickly solving models with different parameter values and coupling with external software, and general bug fixes and optimizations.

docs/source/expression_tree/binary_operator.rst

@@ -28,4 +28,20 @@ Binary Operators
 .. autoclass:: pybamm.Heaviside
   :members:
 
+.. autoclass:: pybamm.EqualHeaviside
+  :members:
+
+.. autoclass:: pybamm.NotEqualHeaviside
+  :members:
+
+.. autoclass:: pybamm.Minimum
+  :members:
+
+.. autoclass:: pybamm.Maximum
+  :members:
+
+.. autofunction:: pybamm.minimum
+
+.. autofunction:: pybamm.maximum
+
 .. autofunction:: pybamm.source

docs/source/expression_tree/unary_operator.rst

@@ -10,6 +10,9 @@ Unary Operators
 .. autoclass:: pybamm.AbsoluteValue
   :members:
 
+.. autoclass:: pybamm.Sign
+  :members:
+
 .. autoclass:: pybamm.Index
   :members:
 
@@ -67,4 +70,12 @@ Unary Operators
 
 .. autofunction:: pybamm.x_average
 
+.. autofunction:: pybamm.r_average
+
+.. autofunction:: pybamm.z_average
+
+.. autofunction:: pybamm.yz_average
+
 .. autofunction:: pybamm.boundary_value
+
+.. autofunction:: pybamm.sign

docs/source/models/submodels/current_collector/index.rst

@@ -10,4 +10,3 @@ Current Collector
   homogeneous_current_collector
   potential_pair
   quite_conductive_potential_pair
-  set_potential_single_particle

docs/source/models/submodels/current_collector/set_potential_single_particle.rst

@@ -0,0 +1,5 @@
+Diffusion-limited
+=================
+
+.. autoclass:: pybamm.interface.DiffusionLimited
+    :members:

docs/source/models/submodels/interface/diffusion_limited.rst

@@ -0,0 +1,5 @@
+First-order Kinetics
+====================
+
+.. autoclass:: pybamm.interface.FirstOrderKinetics
+    :members:

docs/source/models/submodels/interface/diffusion_limited/base_diffusion_limited.rst

@@ -0,0 +1,8 @@
+First-order Kinetics
+====================
+
+.. toctree::
+  :maxdepth: 1
+
+  inverse_first_order_kinetics
+  first_order_kinetics

docs/source/models/submodels/interface/diffusion_limited/full_diffusion_limited.rst

@@ -1,5 +1,5 @@
 Base Inverse First-order Kinetics
 =================================
 
-.. autoclass:: pybamm.interface.inverse_kinetics.BaseInverseFirstOrderKinetics
+.. autoclass:: pybamm.interface.InverseFirstOrderKinetics
     :members:

docs/source/models/submodels/interface/diffusion_limited/index.rst

@@ -5,8 +5,7 @@ Interface
   :maxdepth: 1
 
   base_interface
-  diffusion_limited/index
-  inverse_kinetics/index
   kinetics/index
-  lead_acid
-  lithium_ion
+  inverse_kinetics/index
+  first_order_kinetics/index
+  diffusion_limited

docs/source/models/submodels/interface/diffusion_limited/leading_diffusion_limited.rst

@@ -4,6 +4,4 @@ Inverse Interface Kinetics
 .. toctree::
   :maxdepth: 1
 
-  base_inverse_first_order_kinetics
-  base_inverse_kinetics
   inverse_butler_volmer

docs/source/models/submodels/interface/first_order_kinetics/first_order_kinetics.rst

@@ -1,5 +1,5 @@
 Base Kinetics
 =============
 
-.. autoclass:: pybamm.interface.kinetics.BaseModel
+.. autoclass:: pybamm.interface.BaseKinetics
     :members:

docs/source/models/submodels/interface/first_order_kinetics/index.rst

@@ -1,8 +1,5 @@
 Butler-Volmer
 =============
 
-.. autoclass:: pybamm.interface.kinetics.ButlerVolmer
-    :members:
-
-.. autoclass:: pybamm.interface.kinetics.FirstOrderButlerVolmer
+.. autoclass:: pybamm.interface.ButlerVolmer
     :members:

docs/source/models/submodels/interface/inverse_kinetics/base_inverse_first_order_kinetics.rst docs/source/models/submodels/interface/first_order_kinetics/inverse_first_order_kinetics.rst

@@ -5,7 +5,6 @@ Interface Kinetics
   :maxdepth: 1
 
   base_kinetics
-  base_first_order_kinetics
   butler_volmer
   no_reaction
   tafel

docs/source/models/submodels/interface/index.rst

@@ -1,5 +1,5 @@
 No Reaction
 ===========
 
-.. autoclass:: pybamm.interface.kinetics.NoReaction
+.. autoclass:: pybamm.interface.NoReaction
     :members:

docs/source/models/submodels/interface/inverse_kinetics/base_inverse_kinetics.rst

@@ -1,11 +1,8 @@
 Tafel
 =====
 
-.. autoclass:: pybamm.interface.kinetics.ForwardTafel
-    :members:
-    
-.. autoclass:: pybamm.interface.kinetics.FirstOrderForwardTafel
+.. autoclass:: pybamm.interface.ForwardTafel
     :members:
 
-.. autoclass:: pybamm.interface.kinetics.BackwardTafel
+.. autoclass:: pybamm.interface.BackwardTafel
     :members:

docs/source/models/submodels/interface/inverse_kinetics/index.rst

@@ -9,4 +9,3 @@ X-lumped
   x_lumped_0D_current_collector
   x_lumped_1D_current_collector
   x_lumped_2D_current_collector
-  x_lumped_1D_set_temperature

docs/source/models/submodels/interface/kinetics/base_first_order_kinetics.rst

@@ -3,3 +3,6 @@ Algebraic Solvers
 
 .. autoclass:: pybamm.AlgebraicSolver
   :members:
+
+.. autoclass:: pybamm.CasadiAlgebraicSolver
+  :members: