VA-AM

Documentation#

The documentation is available here.

• API Reference
• How to
• License

Description#

VA-AM (Various Advanced - Analogue Methods) is a Python package based on the deep learning enhancement of the classical statistical Analogue Method. It provides several tools to analyse climatological extreme events, particularly heat waves (HW from now on).

It alows you to perform the identification of the HW following Russo index, use the classical Analogue Method, use the enhanced Autoencoder Analogue Method, and even define own/use diferent deep learning architectures for the Analogue search.

Installation#

Latest version:

Using pip

pip install va_am

Using conda

conda install -c conda-forge va_am

Latest commit:

pip install git+https://github.com/cosminmarina/va_am

Getting Started#

VA-AM can be used inside a python code as library, or directly outside of the code, as a executable. See both options:

Outside of code#

A quick way of using it directly from your terminal. First try the -h | --help flag as:

python -m va_am -h

Note

You should obtain something like:

usage: __main__.py [-h] [-i] [-m METHOD] [-f CONF] [-sf SECRET] [-v] [-t]
           [-p PERIOD] [-sr]

optional arguments:
-h, --help            show this help message and exit
-i, --identifyhw      Flag. If true, first, identify the heatwave period
                        and, then, apply the 'method' if is one of: 'days',
                        'seasons', 'execs', 'latents', 'seasons-execs',
                        'latents-execs' or 'latents-seasons-execs'
-m METHOD, --method METHOD
                        Specify an method to execute between: 'day' (default),
                        'days', 'seasons', 'execs', 'latents', 'seasons-
                        execs', 'latents-execs' or 'latents-seasons-execs'
-f CONF, --configfile CONF
                        JSON file with configuration of parameters. If not
                        specified and 'method' require the file, it will be
                        searched at 'params.json'
-sf SECRET, --secretfile SECRET
                        Path to TXT file with needed information of the
                        Telegram bot to use to WARN and advice about
                        Exceptions. If not specified and 'method' require the
                        file, it will be searched at 'secret.txt'
-v, --verbose         Flag. If true, overwrite verbose param.
-t, --teleg           Flag. If true, exceptions and warnings will be sent to
                        Telegram Bot.
-p PERIOD, --period PERIOD
                        Specify the period where to perform the operations
                        between: 'both' (default), 'pre' or 'post'
-sr, --savereconstruction
                        Flag. If true, the reconstruction per iteration would
                        be saved in ./../../data/ folder as an
                        reconstruction-[name]-[day]-[period]-[AM/VA-AM].nc
                        file.

Inside of code#

You can import va_am as a library in your code and use the equivalent method:

from va_am import

# Perform Variational Autoencoder Analogue search with default args
va_am()

or

import va_am

# Perform Variational Autoencoder Analogue search with default args
va_am.va_am()

Note

The arguments of va_am() method are the same as the outside of code version. For more details see the API reference.

Collaboration#

If you find any bugs/issues or have any suggestions, please open an issue.

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Authors#

• Cosmin M. Marina - Provided Code and Maitenance - cosminmarina
• Eugenio Lorente-Ramos - Provided Code - eugenioLR

See also the list of contributors who participated in this project.

License#

This project is licensed under the GPL v3.0 GNU General Public License - see the LICENSE file for details