Package: va-am
VA-AMDocumentation#The documentation is availablehere.API ReferenceHow toLicenseDescription#VA-AM (Various Advanced - Analogue Methods) is a Python package based on the deep learning enhancement of the classical statisticalAnalogue Method. It provides several tools to analyse climatologicalextreme events, particularlyheat waves(HW from now on).It alows you to perform the identification of the HW followingRusso index, use the classicalAnalogue Method, use the enhanced Autoencoder Analogue Method, and even define own/use diferent deep learning architectures for the Analogue search.Installation#Latest version:Using pippip install va_amUsing condaconda install -c conda-forge va_amLatest commit:pip install git+https://github.com/cosminmarina/va_amGetting 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 -hNoteYou 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 importva_amas a library in your code and use the equivalent method:from va_am import

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

# Perform Variational Autoencoder Analogue search with default args
va_am.va_am()NoteThe arguments ofva_am()method are the same as the outside of code version. For more details see theAPI reference.Collaboration#If you find any bugs/issues or have any suggestions, please open anissue.