in the atmospheric sciences there are many different moist static
energies.  They differ due to the choice of reference enthalpies for
water phases, which are connected by the phase change enthalpies, and
thus have a single degree of freedom.  This we give to the reference
enthalpy (enthalpy at T0) for vapor.  The choice of hv0 matters because
not all reference quantities can be zero for all phases of water, and so
the choice influences how the reference quantity weights different water
phases.

the function has been defined in a rather expressive way to bring out
this property and make it possible to compute one or the other of the
moist static energies by choosing a different reference state for the
vapor enthalpy.

By passing the function that is to be inverted it is possible to write a
generic inversion function, which we call invert_for_temperature and
invert_for_pressure respectively.  These work for all off the
thermodynamic funcions, i.e., theta_e, theta_l, etc.

I experimented with an invert_for_humidity, but this often did nto
converge so I did not introduce this functionality.

Add CI to run doctests

See merge request m219063/aes_thermo!2

I added the calculation of the moist adiabat from the integration of the
first law to the functions, and a generalized definition of the 'dry'
potential temperature, which can account for moisture effects on
thermodynamic parameters.

An additional example was added to show the added functionality.

the murphy and koop (2005) and hardy (1998) formulations for
saturation vapor pressure are sometimes desired.  The former
for their ability to handle saturation over supercooled liquid,
the latter because this equation is frequenly used for the
processing of radio sonde data

added this helper function to make the effect of qt!=qv more clear, a
situation that is found when air is saturated, or has condensate in
disequilibrium.  This is now used in the definition of the moist
potential temperatures.

- added better referenced and more complete docstreams for all of the
functions.
- modified docstring formatting to better align with standards (google)
- cleaned up some stray cells in the examples notebook

- doctests were corrected and now exist for most functions. `
- repository was restructured so example scripts are not outside of main
  repository

Fixed the call and expected outcome statements of the doctest strings in
the funciton documentation.  In doing noticed that for the mixed
supersaturations we should use the minimum, not maximum values, which
reverts a false correction from a previous commit.

Fix doctests

See merge request m219063/aes_thermo!1

The functions are imported into the top-level namespace directly while
the constants are accessible through their submodule namespace.

Some of the routines assume the existence of a directory to
collect plots.  This adds the directory to the repository.

This is a new release.  In addition to cleaning up existing code,
it adds error checking (which identified a few bugs), and a number
of examples taken from my archived (unreleased) library.  This
includes an analysis of different saturation vapor pressure
formulations, the effect of the saturation vapor pressure formulation
on the potential temperatures, and differences in calculations of ths
lifting condensation level.

renamed funcitons with shorter names as longer descriptions are part of
documentation. Began checking functions and documenting expected
answers, which also led to some bug corrections.

resolves m219063/aes_thermo#1
Updated the release so that the module references are now relative
references to avoid conflicts.  This was the last outstanding open
point of the above referenced issue

renamed respository, changing from aes_thermo to moist_thermodynamics.
This resulted in changes in directory and file names

Resolves issue m219063/aes_thermo#2

Initially saturation vapor pressure calls could select which formulation
to use based on a string argument.  Now all calls are made explicitly
visible and a default form is passed to functions that depend on it.
Calls to these functions can however substitute a different form for the
default form.

Initially saturation vapor pressure calls could select which formulation
to use based on a string argument.  Now all calls are made explicitly
visible and a default form is passed to functions that depend on it.
Calls to these functions can however substitute a different form for the
default form.

Originally I had imported the module constants using an absolute
path, now this is modified for a relative import

Added a ipython notebook script with a first example of using the
functions to plot a moist adiabat.

1. The constants were redefined with sybmols and expressive names to
make their use more intuitive and expressive

2. Functions names were made more expressive and small modifications
were made to consistently used previously defined functionality

When separating the constants from the functions the constants were no
longer automatically seen by the functions.  The functions module has
been modified to explicitly access the constants in the constants
module.  The latter also has some inquiry functions that make it easy
to access many constants at once, grouped by usecase.

This contains the basic structure to allow the aes_thermo constants
and functions to be available as a package.

Added cursory information and deleted some template information
from README file