A curated list of open technology projects to sustain a stable climate, energy supply, biodiversity and natural resources.

PyGnome

It is designed to support oil and other hazardous material spills in the coastal environment.
https://github.com/NOAA-ORR-ERD/PyGnome

Category: Hydrosphere
Sub Category: Coastal and Reefs

Last synced: about 18 hours ago
JSON representation

Repository metadata

The General NOAA Operational Modeling Environment

README.rst

          .. image:: graphics/new_gnome_icon/GNOME_logo_450px-wide.png
   :alt: GNOME Logo
   :align: center

#######
PyGNOME
#######


Introduction
============

**GNOME** (General NOAA Operational Modeling Environment) is a modeling tool
developed by the National Oceanic and Atmospheric Administration (**NOAA**),
Office of Response and Restoration (**ORR**), Emergency Response Division.

It is designed to support oil and other hazardous material spills in the
coastal environment, and is also a full featured, flexible particle tracking
system, that can be used for other oceanographic transport applications,
such as fish larvae, marine debris, etc.

PyGNOME is a python package that encapsulates GNOME's functionality.

Disclaimer:
-----------

**This code is under active development**

* It should not be considered an officially endorsed NOAA product.
* Output produced by this code should not be considered endorsed by NOAA.

Documentation
=============

`Project Documentation `_

`FAQ `_


Installation
============

We have put some effort into making this package reasonably easy,
or at least possible, to install on a few different computing platforms:

 - OS-X
 - Windows
 - Linux (tested on CentOS 7)

This package contains modules written in C/C++, and they must be
compiled for this package to function, and we primarily use the Anaconda
distribution of Python for installation.  Anaconda is built primarily for
scientific, engineering, and math applications.
It is now the only supported way to get set up to use ``PyGNOME``,
and it is used in our development and testing process.

`Install using Anaconda <./Installing.rst>`_


The WebGNOME Interface:
=======================

Scripting is the most featurefull way to access PyGNOME's capabilities.
However we have developed a system that allows a user to create and run
PyGNOME models from a web browser.

There is a publicly available instance of WebGNOME at:

https://gnome.orr.noaa.gov

If you want to run your own instance of WebGNOME, the code is in the
following projects:

- `WebGnomeAPI `_:
  A web server that implements the PyGNOME interface
- `WebGnomeClient `_:
  A Web application for setting up and running PyGNOME models

**Fair Warning:**

The WebGNOME system is under active development, and by its very nature
does not expose the full capabilities of PyGNOME.

        

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 7 days ago

Total Commits: 6,347
Total Committers: 46
Avg Commits per committer: 137.978
Development Distribution Score (DDS): 0.716

Commits in past year: 260
Committers in past year: 8
Avg Commits per committer in past year: 32.5
Development Distribution Score (DDS) in past year: 0.692

Name Email Commits
Jasmine Sandhu j****u@n****v 1800
Chris Barker C****r@n****v 1067
jay.hennen j****n@n****v 904
Caitlin O'Connor c****r@n****v 785
James L. Makela j****a@n****v 758
Andrew Brookins a****s@n****v 309
Alex Hadjilambris a****s@o****a 163
Nathan Wilkins n****s@n****v 93
Amy MacFadyen a****n@n****v 79
JamesMakela j****a@g****m 54
Leo Geng l****g@n****v 53
Naomi Wilkins n****s@n****v 42
Brian_Zelenke b****e@n****v 41
DSM d****s@n****v 28
Jasmine Sandhu s****e@g****m 20
Andrew Brookins a****s@g****m 18
Adios Automated Script a****t@n****v 13
aaron.racicot a****t@n****v 13
amy.macfadyen a****n@g****m 12
gennady.kachook G****k@n****v 10
Rachael Mueller r****r@n****v 10
Alexander Miranda a****a@n****v 8
Alex Hadjilambris a****s@O****l 8
Chris Barker c****r@O****l 8
James Makela j****a@O****l 8
heydylan d****i@n****v 6
unknown G****n@O****) 6
Naomi Wilkins n****n@n****v 5
James Makela j****a@o****a 4
Rachael Mueller R****r@n****v 3
and 16 more...

Committer domains:


Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 168
Total pull requests: 15
Average time to close issues: 8 months
Average time to close pull requests: 8 months
Total issue authors: 69
Total pull request authors: 11
Average comments per issue: 5.03
Average comments per pull request: 2.07
Merged pull request: 8
Bot issues: 0
Bot pull requests: 0

Past year issues: 28
Past year pull requests: 1
Past year average time to close issues: 3 days
Past year average time to close pull requests: about 6 hours
Past year issue authors: 13
Past year pull request authors: 1
Past year average comments per issue: 4.57
Past year average comments per pull request: 1.0
Past year merged pull request: 0
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/NOAA-ORR-ERD/PyGnome

Top Issue Authors

  • larissafranklin23 (10)
  • tommasogallingani (8)
  • bobsurf00 (8)
  • fSohrabi75 (8)
  • amirheidari (7)
  • moisespr123 (6)
  • Gronohibari12 (6)
  • Misiorama (6)
  • egiraldof (6)
  • dkobashi (5)
  • tottorikenn (5)
  • rsbragio (4)
  • bhlevca (4)
  • DoctorHamzeh (3)
  • Gronohibari (3)

Top Pull Request Authors

  • ocefpaf (3)
  • HWR-llc (2)
  • kwilcox (2)
  • MElhagaly (1)
  • ChrisBarker-NOAA (1)
  • fchapoton (1)
  • j08lue (1)
  • sandhujasmine (1)
  • tommasogallingani (1)
  • daf (1)
  • moisespr123 (1)

Top Issue Labels

  • question (3)
  • Feature Request (1)

Top Pull Request Labels


Package metadata

proxy.golang.org: github.com/noaa-orr-erd/pygnome

proxy.golang.org: github.com/NOAA-ORR-ERD/PyGnome


Dependencies

docker-compose.yml docker
  • registry.orr.noaa.gov/erd/centos-conda/centos7-python3.8 latest
py_gnome/gnome/utilities/geometry/setup.py pypi
.github/workflows/conda_test.yml actions
  • actions/checkout v4 composite
  • actions/upload-artifact v4 composite
  • conda-incubator/setup-miniconda v3 composite
py_gnome/conda_requirements.txt pypi
  • adios_db >=1.1
  • cell_tree2d *
  • colander <2
  • geojson *
  • geopandas *
  • gridded >=0.6.5
  • gsw *
  • mapbox_earcut *
  • netCDF4 *
  • numpy >=1.24,<2
  • progressbar *
  • psutil *
  • py_gd >=2.2
  • pynucos =3.2.
  • pyogrio *
  • pyproj *
  • python >=3.9,<3.12
  • python-dateutil *
  • pyzmq *
  • scipy *
  • shapely *
  • trimesh *
py_gnome/conda_requirements_build.txt pypi
  • cmake *
  • cython =3.
  • gitpython *
  • ninja *
  • python-build *
  • scikit-build-core >=0.9.9
  • setuptools >=62
py_gnome/conda_requirements_docs.txt pypi
  • nbsphinx *
  • sphinx >=7.2
  • sphinx-autoapi *
  • sphinx_rtd_theme >=1.3
py_gnome/conda_requirements_test.txt pypi
  • pytest * test
  • pytest-cov * test
  • pytest-timeout * test
  • testfixtures * test
py_gnome/pyproject.toml pypi

Score: -Infinity