# Home

![providentia](uploads/providentia.png)

## Overview

Providentia is an evaluation software package developed at the Barcelona Supercomputing Center for the in-depth analysis of in-situ surface observations and colocated model output, tailored specifically for the atmospheric science community.

Providentia has a variety of use modes:

* [Interpolation](Interpolation), to spatially colocate model output with observational stations
* [Dashboard](Dashboard), for interactive quick-look visualisations 
* [Report](Report), for more exhaustive evaluations, generating PDF reports
* [Download](Download-mode), to automatically retrieve and format observational and model datasets
* [Library](Library-mode), for use of Providentia's backend functions in personal scripts or [Jupyter notebooks](Notebooks)

## Getting started

If you are just starting with Providentia please see our handy starting guide: [Getting started](Getting-started)

We also have a number of tutorial notebooks that outline Providentia's features. Please see the [tutorials](https://github.com/BSC-ES/providentia/tree/master/tutorials) subdirectory to find these.

If you wish to see the videos and presentations of all previous Providentia training sessions, please see here: [Training](Training-material)

If you wish to see all scientific and technical presentations releated to Providentia, please see here: [Presentations](Presentations)

The full contents of the Providentia ReadtheDocs documentation can be found here: [Table of Contents](https://providentia.readthedocs.io/en/latest/)

## Bugs / New features

If you encounter a bug while using Providentia, and would like to report it to the Providentia development team please follow these steps:

1. Go to the Providentia GitHub repo [issues page](https://github.com/BSC-ES/providentia/issues).
2. Click on the 'New Issue' button.
3. Select 'Bug report' and fill in the template for fully detailing the bug. 

If you wish to request a new feature follow the same steps, except for step 3 select 'Blank Issue', and fully detail the new feature you would like. 

## Developers

Providentia is developed at the [Barcelona Supercomputing Centre](https://www.bsc.es/) (BSC-CNS).

See here for more information on the developers: [Meet the team](Meet-the-team)