{"id":13738748,"url":"https://github.com/ERDDAP/erddap","last_synced_at":"2025-05-08T18:31:09.503Z","repository":{"id":3195511,"uuid":"4228540","full_name":"ERDDAP/erddap","owner":"ERDDAP","description":"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).","archived":false,"fork":false,"pushed_at":"2025-05-06T17:35:25.000Z","size":129043,"stargazers_count":99,"open_issues_count":45,"forks_count":64,"subscribers_count":25,"default_branch":"main","last_synced_at":"2025-05-06T18:41:58.257Z","etag":null,"topics":["data","environmental","erddap","noaa","scientific","server"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ERDDAP.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":"GOVERNANCE.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2012-05-04T19:50:58.000Z","updated_at":"2025-05-06T17:35:30.000Z","dependencies_parsed_at":"2023-01-12T15:01:23.422Z","dependency_job_id":"e70e1a96-e2b3-4390-8512-546bb5684523","html_url":"https://github.com/ERDDAP/erddap","commit_stats":null,"previous_names":["bobsimons/erddap"],"tags_count":47,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ERDDAP%2Ferddap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ERDDAP%2Ferddap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ERDDAP%2Ferddap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ERDDAP%2Ferddap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ERDDAP","download_url":"https://codeload.github.com/ERDDAP/erddap/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253127003,"owners_count":21858172,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data","environmental","erddap","noaa","scientific","server"],"created_at":"2024-08-03T04:00:15.858Z","updated_at":"2025-05-08T18:31:04.489Z","avatar_url":"https://github.com/ERDDAP.png","language":"Java","funding_links":[],"categories":["ERDDAP","Hydrosphere","数据科学"],"sub_categories":["Ocean and Hydrology Data Access"],"readme":"# ERDDAP\u0026trade;: Easier Access to Scientific Data\n\n**Welcome to the ERDDAP\u0026trade; GitHub repository** \n\nERDDAP\u0026trade; 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\u0026trade; is a Free and Open Source (Apache and Apache-like) Java Servlet developed by the NOAA NMFS SWFSC Environmental Research Division (ERD).\n\nA live ERDDAP\u0026trade; installation can be seen at: https://coastwatch.pfeg.noaa.gov/erddap/index.html.\n\n\u003cdiv style=\"width: 100%; clear: both; align: center\"\u003e\u003cimg src=\"development/images/erddap_sst_graph.jpg\" alt=\"ERDDAP SST data example graph page\" width=\"650\" style=\"margin: 10px; border-width: 1px; border-style: solid; border-color: grey\" /\u003e\u003c/div\u003e\n\n*Example screenshot of ERDDAP\u0026trade;'s web user interface 'Make-a-Graph' page*\n\n\n## Developing with ERDDAP\u0026trade;\n\nERDDAP\u0026trade; is a Java Servlet-based application and can be run in any compatible Java Servlet Container/Application Server, such as Apache Tomcat.\n\nLocal development and testing of ERDDAP\u0026trade; code can be done without a production-scale installation.  Two approaches are recommended:\n\n* **Jetty Servlet Container** - see: [ERDDAP\u0026trade; Development with Maven and Jetty](./development/jetty/).\n* **Docker/Tomcat** (building and running an ERDDAP\u0026trade; development Docker image) - see: [ERDDAP\u0026trade; Development with Docker/Tomcat](./development/docker/)\n\nFor operational ERDDAP\u0026trade; deployment, [Apache Tomcat](https://tomcat.apache.org/) is recommended.  See [Deploying ERDDAP\u0026trade; Operationally](#deploying-erddap-operationally) for instructions.\n\n\n### Running JUnit tests\n\nSimply run `mvn test` in a terminal to run the JUnit tests.\n\nNote 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\u0026trade; so you can generate a baseline set of images that will be later used for comparison.\n\n### Metrics\n\nMetrics 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).\n\n### Building a war\n\n`mvn package` will create a war file. \n\nIf you'd like to skip the tests while building use `mvn package -DskipTests`. You can use the skipTests flags with other maven commands.\n\n### Running the code formatter\n\nTo format code locally you can run:\n\n(Windows)\n`mvn git-code-format:format-code -D\"gcf.globPattern=**/*\"`\n\n(Other)\n`mvn git-code-format:format-code -Dgcf.globPattern=**/*`\n\nCode 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.\n\n## Contributing Code to ERDDAP\u0026trade;\n\nBelow are relevant links for getting involved with the ERDDAP\u0026trade; community and contributing to ERDDAP:\n\n* Review conversations and ask questions at https://groups.google.com/g/erddap or at https://github.com/erddap/erddap/discussions\n* Review and submit issues to https://github.com/erddap/erddap/issues\n* To propose feature requests, follow this guidance: https://github.com/erddap/erddap/discussions/93\n\n\n## Deploying ERDDAP\u0026trade; Operationally\n\nInstructions for installing ERDDAP\u0026trade; in Apache Tomcat are available at: https://erddap.github.io/setup.html.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FERDDAP%2Ferddap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FERDDAP%2Ferddap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FERDDAP%2Ferddap/lists"}