Assessment Metadata¶

Each hazard assessment includes a metadata.json file with information on the assessment’s:

  • Fire Event

  • Implementation

  • Hazard Models, and

  • Input Datasets

and these fields are documented in the PWFDF data spec. The metadata.json info can be useful for documenting individual assessments, and for implementing more complex search filters and analyses. You can stream this information directly into memory using the metadata command.

In brief, this command will search the PWFDF collection, and return the metadata.json info for all matching assessments. You can select the assessments whose metadata should be returned using any of the search filters discussed in the search guide. For example:

pwfdf metadata --fire Eaton --max-fires 1
pwfdf metadata --extent California --start-date 2025-01

When called from the command line, the command will return an array of JSON objects with the metadata of the matching assessments.

Tip

You can save the output JSON object to file using standard shell redirects. For example:

pwfdf metadata --extent California > my-metadata-file.json

from pwfdf_api import metadata

metadata(fire="Eaton")
metadata(extent="California", start_date="2025-01")

When called within a Python session, the command will return a list of dicts, where each dict is the metadata.json info for a particular assessment.