Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ERDDAP/erddap
ERDDAP is a scientific data server that gives users a simple, consistent way to download subsets of gridded and tabular scientific datasets in common file formats and make graphs and maps. ERDDAP is a Free and Open Source (Apache and Apache-like) Java Servlet from NOAA NMFS SWFSC Environmental Research Division (ERD).
https://github.com/ERDDAP/erddap
data environmental erddap noaa scientific server
Last synced: about 1 month ago
JSON representation
ERDDAP is a scientific data server that gives users a simple, consistent way to download subsets of gridded and tabular scientific datasets in common file formats and make graphs and maps. ERDDAP is a Free and Open Source (Apache and Apache-like) Java Servlet from NOAA NMFS SWFSC Environmental Research Division (ERD).
- Host: GitHub
- URL: https://github.com/ERDDAP/erddap
- Owner: ERDDAP
- License: cc0-1.0
- Created: 2012-05-04T19:50:58.000Z (over 12 years ago)
- Default Branch: main
- Last Pushed: 2024-06-10T13:58:24.000Z (7 months ago)
- Last Synced: 2024-06-11T17:27:30.062Z (7 months ago)
- Topics: data, environmental, erddap, noaa, scientific, server
- Language: Java
- Homepage:
- Size: 105 MB
- Stars: 76
- Watchers: 28
- Forks: 53
- Open Issues: 44
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Governance: GOVERNANCE.md
Awesome Lists containing this project
- awesome-erddap - ERDDAP data server - various instances power all the awesome projects on this list (ERDDAP)
README
# ERDDAP™: Easier Access to Scientific Data
**Welcome to the ERDDAP™ GitHub repository**
ERDDAP™ is a scientific data server that gives users a simple, consistent way to download subsets of gridded and tabular scientific datasets in common file formats and make graphs and maps. ERDDAP™ is a Free and Open Source (Apache and Apache-like) Java Servlet developed by the NOAA NMFS SWFSC Environmental Research Division (ERD).
A live ERDDAP™ installation can be seen at: https://coastwatch.pfeg.noaa.gov/erddap/index.html.
*Example screenshot of ERDDAP™'s web user interface 'Make-a-Graph' page*
## Developing with ERDDAP™
ERDDAP™ is a Java Servlet-based application and can be run in any compatible Java Servlet Container/Application Server, such as Apache Tomcat.
Local development and testing of ERDDAP™ code can be done without a production-scale installation. Two approaches are recommended:
* **Jetty Servlet Container** - see: [ERDDAP™ Development with Maven and Jetty](./development/jetty/).
* **Docker/Tomcat** (building and running an ERDDAP™ development Docker image) - see: [ERDDAP™ Development with Docker/Tomcat](./development/docker/)
For operational ERDDAP™ deployment, [Apache Tomcat](https://tomcat.apache.org/) is recommended. See [Deploying ERDDAP™ Operationally](#deploying-erddap-operationally) for instructions.
### Running JUnit tests
Simply run `mvn test` in a terminal to run the JUnit tests.
Note that by default tests that do an image comparison are enabled. To disable those tests add `ImageComparison` to the `excludedGroups` section of the surefire `configuration`. It is recommended you run the image tests before making changes to ERDDAP™ so you can generate a baseline set of images that will be later used for comparison.
### Metrics
Metrics are collected using [Prometheus](https://prometheus.github.io/client_java/). You can see the metrics on a local server at [/erddap/metrics](http://localhost:8080/erddap/metrics?debug=text).
### Building a war
`mvn package` will create a war file.
If you'd like to skip the tests while building use `mvn package -DskipTests`. You can use the skipTests flags with other maven commands.
### Running the code formatter
To format code locally you can run:
(Windows)
`mvn git-code-format:format-code -D"gcf.globPattern=**/*"`
(Other)
`mvn git-code-format:format-code -Dgcf.globPattern=**/*`
Code should be automatically formatted during a git pre-commit step to simplify reviews. It can still be useful sometimes to format code before making a git commit.
## Contributing Code to ERDDAP™
Below are relevant links for getting involved with the ERDDAP™ community and contributing to ERDDAP:
* Review conversations and ask questions at https://groups.google.com/g/erddap or at https://github.com/erddap/erddap/discussions
* Review and submit issues to https://github.com/erddap/erddap/issues
* To propose feature requests, follow this guidance: https://github.com/erddap/erddap/discussions/93
## Deploying ERDDAP™ Operationally
Instructions for installing ERDDAP™ in Apache Tomcat are available at: https://erddap.github.io/setup.html.