Skip to main content

Free Evaluation and Analysis Framework (Freva)

Project description

Free Evaluation System Framework

PyPI version Update Anaconda-Server Badge Docs codecov Pipeline Binder BSD

Freva

What is Freva ?

Freva, the free evaluation system framework, is a data search and analysis platform developed by the atmospheric science community for the atmospheric science community. With help of Freva researchers can:

  • quickly and intuitively search for data stored at typical data centers that host many datasets.
  • create a common interface for user defined data analysis tools.
  • apply data analysis tools in a reproducible manner.

Data analysis is realised by user developed data analysis plugins. These plugins are code agnostic, meaning that users don't have to rewrite the core of their plugins to make them work with Freva. All that Freva does is providing a user interface for the plugins.

Currently Freva comes in three different flavours:

  • a python module that allows the usage of Freva in python environments, like jupyter notebooks
  • a command line interface (cli) that allows using Freva from the command lines and shell scripts.
  • a web user interface (web-ui)

Where can I find the Freva user documentation?

A more detailed overview on the usage of freva can be found on the freva user documentation page

How can I install Freva at my institution?

Deployment is realised via a dedicated repository that holds code to set up the command line and web user interface as well as all services. To deploy the system in production mode consult deployment docs.

How can I set up a local version for development?

To start development with freva clone the repository and its submodules:

git clone --recursive https://github.com/FREVA-CLINT/freva.git

A basic local development setup can be created using Docker and docker-compose (Linux users need to install it separately).

This also requires that the .envrc file is sourced.

docker-compose up -d

Dummy data can be injected into a running docker-compose environment with make dummy-data. This will add some example files into solr and run an example plugin a few times to add some history data.

When finished, tear down the environment with

docker-compose down

Creating a dedicated anaconda dev environment

We recommend using anaconda to install all packages that are needed for development. Here we assume that you have a working anaconda version per-installed on your local computer. To install the dev environment simply use the following command:

conda env create -f dev-environment.yml
source .envrc

This will automatically set environment variables needed for development. The freshly installed environment can be activated:

conda activate freva-dev

The conda environment can be deactivated using the following command:

conda deactivate

Note: The conda install command can be slow. If you want to speed up the installation of the environment we recommend to install the mamba package in the anaconda base environment and use the mamba command to create the environment:

conda install mamba
mamba env create -f dev-environment.yml
source .envrc

Installing the python package

Use the pip install command to install the actual python core packages into your activated environment:

pip install -e .[test]

The -e flag will link the source code into your python environment, which can be useful for development purpose.

Running tests and creating a test coverage report

The system can be tested with a Makefile. To run the tests and generate a simple test coverage report simply use the make command:

make test

The linter testing can be applied by:

make lint

Usage of pre-commit setup

To use the pre-commit setup in freva, follow these steps:

  1. Install Pre-commit:

    • First, install the pre-commit package using pip:
      pip install pre-commit
      
  2. Activate Hooks:

    • Navigate to the root directory of your repository and run the following command to set up the git hooks:
      pre-commit install
      
  3. Automatic Checks:

    • Now, each time you attempt to commit changes, the pre-commit hooks will automatically run to ensure your files adhere to the specified standards.
  4. Manual Execution:

    • If you want to manually run the hooks on all files, use:
      pre-commit run --all-files
      

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

freva-2406.0.0.tar.gz (174.0 kB view details)

Uploaded Source

File details

Details for the file freva-2406.0.0.tar.gz.

File metadata

  • Download URL: freva-2406.0.0.tar.gz
  • Upload date:
  • Size: 174.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for freva-2406.0.0.tar.gz
Algorithm Hash digest
SHA256 0acb1796c29ab1cd3e7353603c5e635299a89cfd3c22a30e267bb62ceb6dae8a
MD5 c0c364fd756758bde186f25f74fd8fc6
BLAKE2b-256 4ea681cfda3ae15dd969d430f40dfa151a9802a3239f1dea5279d6bc5a148e98

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page