Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 

docs/_static/logo.png


This repository shows how you can develop an external package for OGGM and keep control over it without having to put your code on the main OGGM repository.

Why would I want to do that?

Ideally, we would have your package added to the main codebase: this ensures consistency of the code and continuous testing. However, there are several reasons why making your own repository could be useful:

  • complying to OGGM's strict testing rules can be annoying, especially in the early stages of development of a model
  • with you own repository you have full control on it's development while still being able to use the OGGM workflow and multiprocessing capabilities
  • with an external package the users who will use your model will have to download it from your repository and you can make sure that correct attribution is made to your work, i.e. by specifying that using this package requires a reference to a specific scientific publication
  • if your funding agency requires you to have your own public website
  • etc.

Before writing your own package we recommend to contact us to discuss the best path to follow in your specific case.

How does this package work?

This package is a template. It implements two very simple use cases:

  • adding a new "bed inversion" task based on volume-area-scaling but using the OGGM preprocessing workflow
  • using a custom mass-balance model and apply it to OGGM's ice-dynamics model

You can install this custom package with:

pip install git+https://github.com/OGGM/oggmcontrib.git

However, what you'd probably like to do is to fork this repository and use it as a template for your own project. You can install it locally with

pip install -e .

Get in touch

About

An example repository for external OGGM packages

Resources

License

Releases

No releases published

Packages

No packages published

Languages