Climlab

New feature: process class `climlab.radiation.InstantInsolation()` which correctly interprets longitude, respects local solar time and calculates hour angle. A utility function `climlab.solar.insolation.instant_insolation()` is also available, with usage mirroring the existing `climlab.solar.insolation.daily_insolation()`.

Thanks to HenryDane for this contribution!

This release also includes numerous bug fixes, updates for Python 3.11, and improvements to documentation and CI builds.

A major refactor of the internals: all the Fortran code has been moved into external companion packages [climlab-rrtmg](https://github.com/climlab/climlab-rrtmg), [climlab-cam3-radiation](https://github.com/climlab/climlab-cam3-radiation), and [climlab-emanuel-convection](https://github.com/climlab/climlab-emanuel-convection). Climlab is now (once again!) a pure Python package. Builds of these helper packages are available through conda-forge and will be automatically installed as dependencies by conda / mamba.

The climlab source repo also moved to https://github.com/climlab/climlab

There should be no breaking changes to the user-facing API.

The major motivation for this change was to (vastly) simplify the development and testing of new-and-improved climlab internals (coming soon).

This is a maintenance release to support Python 3.10

The [attrdict package](https://github.com/bcj/AttrDict) by [Brendan Curran-Johnson](https://github.com/bcj) has been removed from the dependencies since it is broken on Python 3.10 and no longer under development.

A modified version of the MIT-licensed attrdict source is now bundled internally with climlab. There are no changes to climlab's public API.

New feature: the ability to report top-of-atmosphere emission separated into spectral bands with the RRTMG radiation code.

A new [tutorial notebook](https://climlab.readthedocs.io/en/latest/courseware/Spectral_OLR_with_RRTMG.html) illustrates what you can do with this feature.

The change is completely backwards compatible. A new input flag `return_spectral_olr` has been added to the `RRTMG_LW` process, which defaults to `False`.

Many thanks to AndrewWilliams3142 for leading this new contribution.

This version brings some under-the-hood improvements to the automated download and caching of required data files. These services are now outsourced to [pooch](https://www.fatiando.org/pooch/latest/index.html).

No changes to climlab functionality.

This release brings some modernization to the build and test infrastructure:
- migrating all CI testing to GitHub Actions
- Removing appveyor and travisCI
- renaming the default source code branch from master to main
- Improvements to documentation of build and test procedures