Climlab

This is mostly a bug fix release to fix some issues with the diagnostics created by the new AdvectionDiffusion class introduced in v0.7.4

There are also improvements to the Windows build on Appveyor.

A new flexible 1D advection-diffusion solver:

- `climlab.dynamics.AdvectionDiffusion` is a new parent class for 1D advection-diffusion processes
- Operates along any named axis
- Non-uniform grids are supported
- No breaking changes to existing Diffusion classes; they now subclass `climlab.dynamics.AdvectionDiffusion` and simply set the advecting velocity to zero.
- New numerics are implemented in `climlab.dynamics.adv_diff_numerics`; this module is independent of the `climlab.Process` objects and can be used outside the context of climlab models.
- Improved documentation of the `climlab.dynamics` module

Plus some bug fixes.

Bug fix and changes to continuous integration for Python 2.7 compatibility

Improvements to surface flux processes, a new data management strategy, and improved documentation.

Details:
- ``climlab.surface.LatentHeatFlux`` and ``climlab.surface.SensibleHeatFlux`` are now documented, more consistent with the climlab API, and have new optional ``resistance`` parameters to reduce the fluxes (e.g. for modeling stomatal resistance)
- ``climlab.surface.LatentHeatFlux`` now produces the diagnostic ``evaporation`` in kg/m2/s. ``climlab.convection.EmanuelConvection`` produces ``precipitation`` in the same units.
- The previous ``PRECIP`` diagnostic (mm/day) in ``climlab.convection.EmanuelConvection`` is removed. This is a BREAKING CHANGE.
- Data files have been removed from the climlab source repository. All data is now accessible remotely. climlab will attempt to download and cache data files upon first use.
- ``climlab.convection.ConvectiveAdjustement`` is now accelerated with ``numba`` if it is available (optional)

This release brings deeper xarray integration, include one breaking change to ``climlab.solar.orbital.OrbitalTable``, Python 3.7 compatibility, and minor enhancements.

Details:
- Removed ``climlab.utils.attr_dict.AttrDict`` and replaced with AttrDict package (a new dependency)
- Added ``xarray`` input and output capabilities for ``climlab.solar.insolation.daily_insolation()``
- ``climlab.solar.orbital.OrbitalTable`` and ``climlab.solar.orbital.long.OrbitalTable`` now return ``xarray.Dataset`` objects containing the orbital data.
- The ``lookup_parameter()`` method was removed in favor of using built-in xarray interpolation.
- New class ``climlab.process.ExternalForcing()`` for arbitrary externally defined tendencies for state variables.
- New input option ``ozone_file=None`` for radiation components, sets ozone to zero.
- Tested on Python 3.7. Builds will be available through conda-forge.

New functionality, improved documentation, and a few breaking changes (hopefully for the better) to the API.

Major new functionality includes **convective adjustment to the moist adiabat**, and **moist EBMs with diffusion on moist static energy gradients**.

- ``climlab.convection.ConvectiveAdjustement`` now allows non-constant critical lapse rates, stored in input parameter ``adj_lapse_rate``.
- New switches to implement automatic adjustment to **dry** and **moist** adiabats (pseudoadiabat)
- ``climlab.EBM()`` and its daughter classes are significantly reorganized to better respect CLIMLAB principles:
- Essentially all the computations are done by subprocesses
- SW radiation is now handled by ``climlab.radiation.SimpleAbsorbedShortwave`` class
- Diffusion and its diagnostics now handled by ``climlab.dynamics.MeridionalHeatDiffusion`` class.
- Diffusivity can be altered at any time by the user, e.g. during timestepping
- Diffusivity input value ``K`` in class ``climlab.dynamics.MeridionalDiffusion`` is now specified in physical units of m2/s instead of (1/s). This is consistent with its parent class ``climlab.dynamics.Diffusion``.
- A new class ``climlab.dynamics.MeridionalMoistDiffusion`` for the moist EBM (diffusion down moist static energy gradient)
- Tests that require compiled code are now marked with ``pytest.mark.compiled`` for easy exclusion during local development

Under-the-hood changes include

- Internal changes to the timestepping; the ``compute()`` method of every subprocess is now called explicitly.
- ``Process.compute()`` now always returns tendency dictionaries