Skip to main content

Impact Forecasting for the Climate Impact Lab

Project description


.. image::

.. image::

.. image::
:alt: Documentation Status

.. image::
:alt: Updates

Impact Forecasting for the Climate Impact Lab

* Free software: MIT license
* Documentation:

Setting up this package

*Justin Simcock: complete these instructions and then remove this section from
the readme.*

1. Create a matching repository on github if you haven't already:

a. go to
b. enter the following information:


Repository Name

Impact Forecasting for the Climate Impact Lab


**Do not initialize the repo with a readme, license, or gitignore!**

c. Press the big green buttton

2. Execute the following commands in this directory:

.. code-block:: bash

git init
git add .
git commit -m "initial commit"
git remote add origin
git push -u origin master

3. Set up automated testing, coverage, updates, and docs:

a. Set up testing

i. go to and sign in/sign up with github.
Make sure travis has access to the repositories on your github
account *and* those owned by the ClimateImpactLab by enabling
access in your account settings.
ii. Next to "My Repositories" click the '+' icon
iii. Flip the switch on ClimateImpactLab/impax. If
you don't see it in the list, click 'Sync account', and make
sure you are looking at the ClimateImpactLab repositories.
iv. Push a change to your package (for example, you could delete
this section). You should see tests start running on travis
v. Start writing tests for your code in the
``impax/tests`` folder. There are some
examples already in there to get you started.

b. Set up docs

i. go to and sign in/sign up with github.
Same deal - make sure readthedocs has access to your github
account and ClimateImpactLab.
ii. click 'Import a project', go to ClimateImpactLab, and refresh.
iii. click the '+' icon next to
ClimateImpactLab/impax. Pick a name for your
project. The name has to be globally unique (not just within
the ClimateImpactLab), so if you chose something with a common
name you may have to rename the docs.
iv. go to the settings page for your new docs site, and navigate to the 'advanced settings' tab.
add `requirements_rtd.txt` to the "requirements file" field.
v. next time you push code to master, docs should build
automatically. You can view them at
(substitute whatever name you chose).

c. Set up updates

i. go to you know the drill.
ii. Go to your account, and click '+ Add Repo'. Sync.
iii. Add ClimateImpactLab/impax
with "Dependency Updates" and "SafetyCI" turned on. Leave
"Update Schedules" off.

d. Set up test coverage monitoring

i. next up: you got this.

e. Breathe easy. The next time you push code, these should all update for
you! Now that wasn't so bad, was it?

4. Develop with github:

a. In general, it's best to file an issue when you want to change something
or when you've found a bug, then write tests which test a-priori
assertions about desired behavior, and then write the minimum amount of
code required to pass these tests. See the contributing docs for more
workflow suggestions.

To run all tests on your local machine:

.. code-block:: bash

make test

5. Deploy

a. Set up deployment by registering the package on the python package index

i. Create an account on PyPI:
ii. Register the package:

.. code-block:: bash

python register

iii. Encrypt & package your credentials so travis can deploy for you:

.. code-block:: bash


b. When you're ready to deploy this package, make sure all your changes are
committed. Then run:

.. code-block:: bash

bumpversion patch # (or minor or major)
git push
git push --tags

As soon as this new tagged commit passes tests, travis will deploy for

c. Anyone (in the world) should now be able to install your package with

.. code-block:: bash

pip install [package-name]




This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter:
.. _`audreyr/cookiecutter-pypackage`:


0.1.2 (Current version)

API changes

* :py:func:`impax.csvv.get_gammas` has been deprecated. Use :py:func:`impax.read_csvv` instead (:issue:`37`)
* :py:meth:`~impax.csvv.Gammas._prep_gammas` has been removed, and :py:meth:`~impax.csvv.Gammas.sample` now
takes no arguments and returns a sample by default. Seeding the random number generator is now left up to
the user (:issue:`36`)

Bug fixes

* fix py3k compatability issues (:issue:`39`)
* fix travis status icon in README
* add tests for :py:func:`impax.mins._minimize_polynomial`, fix major math errors causing a failure to find minima in :py:mod:`impax.mins` module, and clarify documentation (:issue:`58`)

0.1.0 (2017-10-12)

* First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

impax-0.1.2.tar.gz (22.9 kB view hashes)

Uploaded source

Built Distribution

impax-0.1.2-py2.py3-none-any.whl (13.6 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page