From bda397793a8f439e8e81409d3728ef735a6e8758 Mon Sep 17 00:00:00 2001 From: Carsten Hinz <chinz@zam294.zam.kfa-juelich.de> Date: Thu, 25 Apr 2024 16:37:42 +0200 Subject: [PATCH] started writing of a README file. Create a basic structure and added the first content --- README.md | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) diff --git a/README.md b/README.md index e69de29..0c1337f 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,44 @@ +TOAR Gridding Tool +==== + +# About + +The TOARgridding projects data from the TOAD database () onto a grid. +The stations within one cell of the grid are averaged. + +The tool handels the request to the database over the REST API and the subsequent processing. +The results are provided as xarray objects for subsequent processing by the user. + +This project is a beta with some basic functionalities. + +# Installation + +Move to the folder you want to create download this project to. + +Clone the project from its git repository +``` +git clone https://gitlab.jsc.fz-juelich.de/esde/toar-public/toargridding.git +``` + +The handling of required packages is done with poetry. +For installing them go to the new created directory and run poetry +``` +cd toargridding +poetry install +``` + +# Example + +There are at the moment three example provided as jupyter notebooks: +tests/procude_data.ipynb provides an example on how the high level interface can be used. +get_sample_data.ipynb downloads already sampled data from the TOAR database. +quality_controll.ipynb processes the data of obtained with get_sample_data.ipynb. + +# Supported Grids + +The first supported grid is the Cartesian grid. + +# Supported Variables + + + -- GitLab