ioos / ioos_metrics

Working on creating metrics for the IOOS by the numbers
https://ioos.github.io/ioos_metrics/
MIT License
2 stars 4 forks source link

ioos-metrics

A library to compute and compile metrics about the U.S. Integrated Ocean Observing System (U.S. IOOS®). U.S. IOOS® is a vital tool for tracking, predicting, managing, and adapting to changes in our ocean, coastal and Great Lakes environment.

Creating metrics for the IOOS by the numbers.

"IOOS by the Numbers" is was developed as a graphical representation of IOOS -- a system of includes our partnerships, research and observing components, and data management capabilities. This figure is an annually updated collection of numbers that show the breadth of the IOOS Program as it is growing and evolving.
These data were obtained from multiple sources in July 2022. The original source for each value is identified below. Links to each federal partner or regional association are provided.

Installation instructions:

conda

conda install ioos-metrics

pip

pip install ioos-metrics

Usage

See https://github.com/ioos/ioos_metrics/tree/main/notebooks

Website

url: https://ioos.github.io/ioos_metrics/

Leveraged existing resources from https://github.com/noaa-fisheries-integrated-toolbox/toolbox_web_templating.

The webpages are built from the website/ directory.

File(s) Description
*_config.json configuration for what resources to present on the webpages.
create_asset_inventory_page.py script to create https://ioos.github.io/ioos_metrics/asset_inventory.html
create_gts_atn_page.py script to create https://ioos.github.io/ioos_metrics/gts_atn.html
create_gts_regional_landing_page.py script to create https://ioos.github.io/ioos_metrics/gts_regional.html
deploy/index.html html source for landing page https://ioos.github.io/ioos_metrics/index.html
deploy/static/main.css css control for website.

Development

To create the webpages on your local system

git clone https://github.com/ioos/ioos_metrics.git
cd ioos_metrics/website
python create_asset_inventory_page.py
python create_gts_atn_landing_page.py
python create_gts_regional_landing_page.py

All the webpages will be saved to website/deploy. You can view the local html files with a web browser for testing.

Deployment

The website is generated using GitHub Actions and GitHub Pages. The python scripts, referenced above, are ran and the directory website/deploy is then uploaded as an artifact for GitHub Pages to serve as a website. This process is automatically ran with every push to the main branch. See here.