Skip to content

FEMA/openfema-samples

Repository files navigation

OpenFEMA Samples

This repository contains code, dataset, and analysis samples that utilize the OpenFEMA API as a data source. This will provide an additional mechanism for the public and FEMA's Whole Community partners to collaborate with FEMA. Each folder contains a README file with additional information.

OpenFEMA

FEMA collects data on multiple aspects of emergency management—Disaster Information, Individual Assistance, Public Assistance, Hazard Mitigation, National Flood Insurance Program (NFIP), Emergency Management, Preparedness, and Grants. OpenFEMA is the public’s resource for this data. OpenFEMA’s mission is to promote a culture of Open Government within FEMA and increase transparency, participation, and collaboration among the Whole Community in support of FEMA’s mission of helping people before, during, and after disasters.

See the OpenFEMA website to access dataset downloads and the application programming interface (API) that provides data in an easily digestible, machine readable format.

Public Feedback & Contribution

We encourage your feedback and contributions to this repository. Content suggestions and discussions (specific to OpenFEMA) can be communicated in the following ways:

  • GitHub “issues.” Each issue is a conversation about specific project work initiated by a member of the public.
  • GitHub "discussions". Each discussion is a project communication forum. Discussions are not specific to elements of work like a pull request. We encourage you to browse and join in on discussions or start a new conversation by creating a new discussion.
  • Direct changes and line edits to the content may be submitted through a "pull request" by clicking "Edit this page" on any site page in the repository. You do not need to install any software to suggest a change. You can use GitHub's in-browser editor to edit files and submit a pull request for your changes to be merged into the document. Directions on how to submit a pull request can be found on GitHub.
  • Send your content suggestions or proposed revisions to the OpenFEMA team via email to openfema@fema.dhs.gov. Please note that all comments received may or may not be posted publicly on this page.

OpenFEMA now uses GovDelivery to inform users of system outages, dataset deprecations, new datasets, and new API features. Notifications will be infrequent - probably no more than one per month. FEMA respects your privacy and will never use your email for purposes other than OpenFEMA notifications. You may unsubscribe at any time. If interested, subscribe to GovDelivery for OpenFEMA.

We encourage you to read this project's Code of Conduct CONTRIBUTING policy and its LICENSE.

Third-Party Uses of OpenFEMA

The following GitHub projects are included here as examples of tools and analysis that users of OpenFEMA have created. If you would like a project mentioned here, send an email to openfema@fema.gov. We don't expect production quality code but the code must run and have reasonably good documentation. Tool repositories without activity for more than 5 years will be removed from this list. Analysis repositories will remain.

Note: FEMA does not endorse any of the projects mentioned in this list. FEMA did not create these projects and applications, has not tested them, and makes no claim as to the assurance of their efficacy, security, or reliability. They are used here for illustrative purposes only.

Tools

  • OpenFEMANgClient - An Angular (i.e., 'Ng') and Typescript application that provides a sample approach for accessing a few of the disaster related datasets. A proof-of-concept tool with a focus on emergency operations.
  • openfema-api-python-client - A Python wrapper for the OpenFEMA API. Currently in beta and only works for 3 datasets.
  • rfema (R FEMA) - An R framework for accessing the OpenFEMA API. Well documented and works for all OpenFEMA datasets.
  • NFHL: National Flood Hazard Layers - Although not OpenFEMA related, this deserves mention. It is an R implementation/wrapper for the NFHL API.

Analysis

Public domain

This project is in the worldwide public domain. As stated in CONTRIBUTING:

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.