verif 1.3.0.dev1__tar.gz → 1.4.0b2__tar.gz

verif-1.4.0b2/.github/workflows/python-package.yml

@@ -0,0 +1,44 @@
+# This workflow will install Python dependencies, run tests and lint with a variety of Python versions
+# For more information see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions
+
+name: Python package
+
+on:
+  push:
+    branches: [ master, test ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10"]
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        # sudo apt install libgeos-dev libproj-dev
+        python -m pip install --upgrade pip
+        python -m pip install flake8 nose
+    - name: Install package
+      run: |
+        python -m pip install .[test] --only-binary=:all:
+    - name: Lint with flake8
+      run: |
+        # stop the build if there are Python syntax errors or undefined names
+        flake8 verif scripts --count --select=E9,F63,F7,F82 --show-source --statistics
+        # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
+        # flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+    - name: Test with nose
+      run: |
+        coverage run --source verif -m unittest discover
+        coverage report --precision 2
+

verif-1.4.0b2/.gitignore

@@ -0,0 +1,16 @@
+*.pyc
+dist
+build
+*.egg-info
+*~
+.coverage
+cover
+.*.swp
+deb_dist
+test.csh
+testPlots/
+stdeb.cfg
+devel/
+.tox
+deps
+.vscode

{verif-1.3.0.dev1 → verif-1.4.0b2}/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2013-2022, Weather Forecast Research Team
+Copyright (c) 2013-2025, Weather Forecast Research Team
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

verif-1.4.0b2/PKG-INFO

@@ -0,0 +1,35 @@
+Metadata-Version: 2.4
+Name: verif
+Version: 1.4.0b2
+Summary: A verification program for meteorological forecasts and observations
+Author-email: Thomas Nipen <thomasn@met.no>
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/WFRT/verif
+Keywords: meteorology,verification,weather prediction
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Development Status :: 5 - Production/Stable
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.7
+Requires-Dist: matplotlib
+Requires-Dist: scipy
+Requires-Dist: netCDF4
+Requires-Dist: PyQt6
+Requires-Dist: cartopy
+Provides-Extra: test
+Requires-Dist: coverage; extra == "test"
+Requires-Dist: pep8; extra == "test"
+Requires-Dist: pylint; extra == "test"
+Requires-Dist: flake8; extra == "test"
+Dynamic: license-file

verif-1.4.0b2/README.rst

@@ -0,0 +1,107 @@
+Forecast verification software
+==============================
+.. image:: https://img.shields.io/github/v/release/WFRT/verif.svg
+  :target: https://github.com/WFRT/verif/releases
+  :alt: Release badge
+.. image:: https://github.com/WFRT/verif/actions/workflows/python-package.yml/badge.svg
+  :target: https://github.com/WFRT/verif/actions/workflows/python-package.yml
+  :alt: CI badge
+.. image:: https://img.shields.io/badge/DOI-10.1175%2FBAMS--D--22--0253.1-blue
+  :target: https://doi.org/10.1175/BAMS-D-22-0253.1
+  :alt: Bams Article
+
+Verif is a command-line tool that lets you verify the quality of weather forecasts for point
+locations. It can also compare forecasts from different forecasting systems (that have different
+models, post-processing methods, etc).
+
+The program reads files with observations and forecasts in a specific format (see "Input files"
+below). The input files contain information about dates, forecast lead times, and locations such
+that statistics can be aggregated across different dimensions. To ensure a fair comparison among
+files, Verif will discard data points where one or more forecast systems have missing forecasts.
+Since Verif is a command-line tool, it can be used in scripts to automatically create
+verification figures.
+
+Verif version 1.3 has been released (see "Installation Instruction" below). We welcome suggestions
+for improvements. Verif is developed by Thomas Nipen (thomasn@met.no), with contributions from many.
+
+Features
+--------
+
+* Deterministic metrics such as MAE, bias, correlation, RMSE (e.g. ``-m mae``)
+* Threshold-based metrics such as the false alarm rate, ETS, EDI, Yule's Q (e.g. ``-m ets``)
+* Probabilistic metrics such as brier score, PIT-histogram, reliability diagrams (e.g. ``-m bs``)
+* Special plots like Taylor diagrams (``-m taylor``), quantile-quantile plots (``-m qq``).
+* Plot scores as a function of date, lead time, station altitude/lat/longitude (e.g. ``-x date``)
+* Show scores on maps (``-type map``)
+* Subset the data by specifying a date range and lat/lon range (``-latrange 58,60``)
+* Export to text (``-type text``)
+* Options to adjust font sizes, label positions, tick marks, legends, etc (``-labfs 14``)
+* Anomaly statistics relative to a baseline like climatology (``-c climfile.txt``)
+* Output to png, jpeg, eps, etc and specify dimensions and resolution (``-f image.png -dpi 300``)
+
+Resources
+---------
+
+* Check out the **wiki** at https://github.com/WFRT/verif/wiki.
+* Found a bug? Please report it in the **issue tracker** at https://github.com/WFRT/verif/issues.
+* Reach out to the Verif community in the **discussions** at https://github.com/WFRT/verif/discussions.
+* Check out our `article <https://journals.ametsoc.org/view/journals/bams/104/9/BAMS-D-22-0253.1.xml>`_ published in BAMS.
+
+.. image:: other/image.jpg
+    :alt: Example plots
+    :width: 400
+    :align: center
+
+Getting started
+---------------
+
+The easiest way to get started is to install verif with pip:
+
+.. code-block:: bash
+
+    pip3 install verif
+
+The `verif` command-line program should then be available.
+
+Note that the python package "cartopy" is optional and not installed by default when verif is
+installed, Verif uses "cartopy" for creating a background map when verification scores are plotted
+on a map. To install Cartopy run
+
+.. code-block:: bash
+
+    pip3 install cartopy
+
+To upgrade to a newer version of Verif, run the following:
+
+.. code-block:: bash
+
+   pip3 install verif --upgrade
+
+Examples
+--------
+To test Verif, you can download example datasets from the github
+`discussion page <https://github.com/WFRT/verif/discussions>`_. For example, download the following two files from the wind speed dataset: `MEPS.nc <https://thredds.met.no/thredds/fileServer/metusers/thomasn/verif_datasets/short_range_wind/MEPS.nc>`_ (2.5 km regional model; 20MB file size) and `ECMWF.nc <https://thredds.met.no/thredds/fileServer/metusers/thomasn/verif_datasets/short_range_wind/ECMWF.nc>`_ (0.2° global model; 24MB file size). Then run the following
+commands to test out the software:
+
+.. code-block:: bash
+
+   # Shows mean absolute error as a function of lead-time
+   verif MEPS.nc ECMWF.nc -m mae
+   # Shows average observed and forecasted values as a function on time
+   verif MEPS.nc ECMWF.nc -m obsfcst -x time
+   # Shows equitable threat score as a function of threshold
+   verif MEPS.nc ECMWF.nc -m ets
+   # Shows a reliability diagram for a threshold of 13.9 m/s (gale force winds)
+   verif MEPS.nc ECMWF.nc -m reliability -r 13.9
+   # Shows Brier skill score as a function of threshold
+   verif MEPS.nc ECMWF.nc -m bss -x threshold
+
+How to cite
+-----------
+Nipen, T. N., R. B. Stull, C. Lussana, and I. A. Seierstad, 2023: `Verif: A Weather-Prediction Verification Tool for Effective Product Development <https://journals.ametsoc.org/view/journals/bams/104/9/BAMS-D-22-0253.1.xml>`_. Bull. Amer. Meteor.  Soc., 104, E1610–E1618, https://doi.org/10.1175/BAMS-D-22-0253.1.
+
+Copyright and license
+---------------------
+
+Copyright © 2013-2026 UBC Weather Forecast Research Team. Verif is licensed under the 3-clause
+BSD license. See LICENSE file.