NASA ARSET Introduction to the GEDI Mission and its Derived Products
The Story
Welcome to this highly fascinating and technically rich episode of the NASA Live Video Podcast: "NASA ARSET: Introduction to the GEDI Mission and its Derived Products."In this episode, we venture into the heart of Earth's forests to explore how spaceborne lasers are revolutionizing our understanding of global carbon cycles and ecosystem structures. Operating from the International Space Station (ISS), NASA's GEDI (Global Ecosystem Dynamics Investigation) mission uses high-resolution laser ranging to provide the first high-quality measurements of forest canopy height, canopy vertical structure, and surface elevation globally.
Through the framework of NASA’s Applied Remote Sensing Training (ARSET) program, we introduce the foundational concepts of the GEDI mission and its core technology: full-waveform LiDAR. We break down the key derived data products available to the scientific community, explaining how researchers utilize GEDI data to estimate aboveground biomass, map complex forest structures, and improve biodiversity assessments and climate change modeling.
Whether you are an ecologist, a climate scientist, a forestry professional, a GIS analyst, or a space enthusiast eager to discover how NASA uses lasers from orbit to weigh the world's trees, this episode offers vital, foundational insights. Subscribe to the NASA Live Video Podcast to stay at the absolute forefront of space exploration, remote sensing data, and cutting-edge earth science!
Speaker 1: Welcome to our training series Spaceborne lightar for Monitoring vegetation,
Speaker 1: structure and biomass using Jedi. My name is Savannah Cooley.
Speaker 1: I'm a researcher at NASA Ames Research Center with the
Speaker 1: Bay Area Environmental Research Institute in Mountain View, California, and
Speaker 1: I'm a trainer with the RSET Ecological Conservation Team. There
Speaker 1: are three parts in this training. In Part two, today
Speaker 1: will further introduce the Jedi mission and its data products
Speaker 1: with the hands on exercise for accessing and analyzing data
Speaker 1: from Jedi's level to b HDF five files. Part one
Speaker 1: covered full waveform lightar foundations, and Part three will cover
Speaker 1: estimating biomass change with the OBI one application. Remember that
Speaker 1: the homework opens on the last day of the training
Speaker 1: on November six, twenty five. It is due two weeks
Speaker 1: later on November twentieth. A certificate of completion will be
Speaker 1: awarded to participants who attend all live sessions and complete
Speaker 1: the homework assignment before the given due date. Let's dive
Speaker 1: into Part two of the series, introduction to the Jedi
Speaker 1: mission and its derived products. We have one guest instructor
Speaker 1: for Part two. Stephanie Humenis is a research associate with
Speaker 1: the Satellite Needs Working Group Management Office based out of
Speaker 1: the National Space Science and Technology Center with NASA Marshall's
Speaker 1: Space Flight Center and the University of Alabama and Huntsville
Speaker 1: Earth System Science Center. Additional support for this training came
Speaker 1: from NASA earth Rise, an Earth Action program at Marshall's
Speaker 1: Space Flight Center. I would like to acknowledge our fellow
Speaker 1: colleagues at NASA earth Rise who supported the development of
Speaker 1: this training. There are three learning objectives for this session.
Speaker 1: By the end of the session, participants will be able
Speaker 1: to first identify the general characteristics, strengths, and limitations of
Speaker 1: the Jedi mission and its data. Second, identify Jedi data
Speaker 1: products and their characteristics for elevation, canopy, height, vegetation structure,
Speaker 1: and biomass estimation. Third, access and visualized Jedi elevation, height, vegetation, structure,
Speaker 1: and biomass data sets for an area of interest using
Speaker 1: openly available tools. If you have questions during today's training,
Speaker 1: you can put them in the Q and A box
Speaker 1: within WebEx at any time. At the end of the training,
Speaker 1: we will address as many questions as we can, and
Speaker 1: we will post these questions and written answers to the
Speaker 1: training page within a week after the training. With that,
Speaker 1: I will pass to Stephanie.
Speaker 2: All right, and with that, let's dive into Section one,
Speaker 2: which reviews what the JEDI mission is and how its
Speaker 2: data for ecosystem structure can be used. JEDI is a
Speaker 2: joint project between the University of Maryland and NASA Goddard
Speaker 2: Spaceflight Center and is a NASA Ventures instrument housed aboard
Speaker 2: the International Space Station. The sensor produces high resolution laser
Speaker 2: ranging observations of three dimensional structures on Earth's surface. The
Speaker 2: use of near infrared wavelength and the science team's waveform
Speaker 2: processing algorithms enable JEDI to optimally capture detail in the
Speaker 2: structure and density of vegetation. The mission was launched in
Speaker 2: twenty eighteen and began collecting data from April twenty nineteen
Speaker 2: through March twenty twenty three, but from March twenty twenty
Speaker 2: three to April twenty twenty four the instrument went into hibernation,
Speaker 2: but has since returned return of the JEDI and will
Speaker 2: collect data through this decade. So the purpose of this
Speaker 2: mission is to assess the current state of Earth's forest structure.
Speaker 2: From these measurements, models can be tested to observe how
Speaker 2: forest dynamics have changed historically and predict how they may
Speaker 2: change over time. From each JEDI sample or observation, we
Speaker 2: gain a better understanding of how ecosystems are structured dynamically.
Speaker 2: These novel perspectives of ecosystem structure can better inform the
Speaker 2: status of habitat quality and other biodiversity indicators when combining
Speaker 2: the data with other ecosystem information. JEDI not only observes forests,
Speaker 2: but it can summarize topography below vegetated canopies, track surface deformation,
Speaker 2: assess continental and coastal water resources, and even predict weather impacts.
Speaker 2: JEDI can inform human to landscape interactions, such as when
Speaker 2: managing e ecosystems, modeling fires, and assessing the carbon cycle
Speaker 2: with its data. So the next fuel Slides will offer
Speaker 2: a brief overview of possible applications of JEDI data. Biomass
Speaker 2: estimations are essential for quantifying carbon storage inflexes in terrestrial ecosystems.
Speaker 2: Information on biomass can inform models of the carbon cycle
Speaker 2: by constraining estimates of carbon sources and sinks. Improved models
Speaker 2: enable more accurate assessments of how forests contribute to climate regulation.
Speaker 2: Biomass can be modeled from jedi's data since it captures
Speaker 2: vegetation height and structure. Jedi's biomass estimations at the footprint
Speaker 2: and graded scales provide high resolution and globally consistent measurements
Speaker 2: to track global carbon budgets. Jedi's height metrics and its
Speaker 2: ability to measure structural complexity make it possible to assess
Speaker 2: dynamics in vegetation strata, ages, types, in competition, etc. As
Speaker 2: shown in the leftmost image. From this more in depth
Speaker 2: understanding of vegetation, professionals can better inform their efforts in conservation, restoration,
Speaker 2: habitat modeling, and fire management. An example data flow in
Speaker 2: the rightmost figure demonstrates how local measurements are matched to
Speaker 2: landscape scale measurements like those from JEDI or other remote
Speaker 2: sensing satellite based sources. Integrating data at this scale over
Speaker 2: time enables greater spatial extent to monitor fuels or vegetation
Speaker 2: regrowth or ecosystem disturbances. JEDI data provide detail measurements of
Speaker 2: the canopy, structure and ground elevation, which enhance land surface
Speaker 2: models used in weather prediction by improving the representation of vegetation, height,
Speaker 2: density and distribution. JEDI data can help refine simulations of
Speaker 2: surface energy balance, evapotransporation, and n and even wind dynamics.
Speaker 2: Each of these are diversely influenced by different ecosystem structures.
Speaker 2: These atmospheric effects are key processes influencing local and regional
Speaker 2: atmospheric conditions. LIGHTAR in general is commonly used to monitor
Speaker 2: water volume changes, wetland water levels, river reach slopes, stages,
Speaker 2: or discharge across inland water surfaces or coastal regions. JEDI
Speaker 2: can support these same hydrological analyzes with its sub kilometer
Speaker 2: sampling of elevation, including that of water and water under
Speaker 2: highly vegetated areas such as in mangrove forests. Accurate elevation data,
Speaker 2: including those beneath vegetation, are essential for mapping topography and
Speaker 2: detecting surface deformation, such as in landslides or subsidence. Understanding
Speaker 2: elevation and slope changes, especially below forest canopies, can be
Speaker 2: crucial for disaster risk management, such as when managing and
Speaker 2: responding to flooding, fire spread, or landslides, by capturing precise
Speaker 2: ground elevations, even in densely forested areas. JEDI enhances elevation
Speaker 2: modeling across diverse land cover types, so the mission specifications
Speaker 2: could potentially impact your ability to apply its datas products
Speaker 2: for your study area. This is a reference table for
Speaker 2: recognizing systematic considerations which may impact data availability. Given that
Speaker 2: JEDI is on the International Space Station, it only samples
Speaker 2: between fifty one point six degrees north and south, leaving
Speaker 2: out the far southern and northern study areas or regions
Speaker 2: of the globe, which are actually shaded in blue gray
Speaker 2: on the map below. It is important to recognize the
Speaker 2: sampling density of the sensor itself, where each of the
Speaker 2: eight beams lie six hundred meters apart and each sample
Speaker 2: or footprint is located sixty meters from the other within beam.
Speaker 2: Temporal availability is important as well, those samples may be
Speaker 2: available Spatially available records only fall between April twenty nineteen
Speaker 2: to March twenty twenty three, and then again from April
Speaker 2: twenty twenty four until now. Where data is available, the
Speaker 2: resolution and geolocation accuracy may be a big contender in
Speaker 2: how representative that data is of your desired application. Updated
Speaker 2: versioning and improved data products such as Fusing JEDI with
Speaker 2: other full coverage data sets like optical or SAR can
Speaker 2: improve accuracies, but may change resolutions. The twenty five meter
Speaker 2: footprints are valuable for their higher resolution and customizability, while
Speaker 2: the one kilometer or more grids and fused products may
Speaker 2: provide more reliable information for landscape scale studies. Spaceborne lightar
Speaker 2: is an incredible novel technology advancing the field of light ar,
Speaker 2: which has been a common and trusted remote sensing technique
Speaker 2: used to manage and monitor land and water across available
Speaker 2: light our systems, whether free and open sources or commercial.
Speaker 2: There are several major differences and or trade offs, as
Speaker 2: shown in the figure. Various methods for measuring vegetation with
Speaker 2: light ar or field studies occur at different spatial sampling
Speaker 2: patterns has shown on the bottom, or sampling resolutions as
Speaker 2: shown in the middle, and by the size of the beams,
Speaker 2: which are part in part dictated by the light our
Speaker 2: system itself, as you can visualize by the altitude of
Speaker 2: the sensors. As with many applications, some of the most
Speaker 2: trusted data are with field plots or human light observation.
Speaker 2: While highly accurate field surveys can be costly and time consuming,
Speaker 2: involving a lot of manual input. Because of this, these
Speaker 2: campaigns tend to cover small areas and are collected inconsistently,
Speaker 2: making it difficult to pair timely relevant data with other
Speaker 2: remote sensing products. Terrestrial light OAR systems or TLS are
Speaker 2: similarly reliable since they are placed on the ground in location.
Speaker 2: TLS can be costly, costly instruments and require specialized software, computation, storage,
Speaker 2: or skills to process and interpret the results, while quicker
Speaker 2: and incredibly detailed repeat coverage can also be costly. Airborne
Speaker 2: light our systems like NASA ELVIS, which is the land
Speaker 2: vegetation and ice system based out of the NASA Jet
Speaker 2: Propulsion Laboratory, can be used to calibrate and validate spaceborn
Speaker 2: light our missions like the ISATS and JEDI, because they
Speaker 2: cover large areas while collecting high density and accurate observations.
Speaker 2: Unmanned aerial vehicles like drones are similarly flexible. Greater spatial
Speaker 2: coverage can promote increased frequency of observation and coverage when funded,
Speaker 2: yet also require specialized software, computation, storage, and skills to
Speaker 2: process and interpret large amounts of data. Space based lighter
Speaker 2: though a great technological feat introduce trade off in accuracy
Speaker 2: and resolution compared to airborne UAV, terrestrial light our and
Speaker 2: field plot data. The density of the data may vary
Speaker 2: though repake coverage over a particular landscape. Globally, it is
Speaker 2: highly advantageous. While NASA works to improve accuracy, accessibility, and
Speaker 2: ease users skills to interpret the data, the ISAT missions
Speaker 2: and JEDI remain free and open source on public repositories.
Speaker 2: Many field inventory plots or other field data plots were
Speaker 2: used to derive jedimetrics based on alemetric equations that relate
Speaker 2: what is observed and measured on the ground with what
Speaker 2: JEDI and other remote sensors capture. The field inventory and
Speaker 2: analysis plots can also be used for local calibration or
Speaker 2: validating results. NASA has committed the past few decades to
Speaker 2: advancing space based light our systems. Here are the Earth
Speaker 2: observing satellites collecting light our perspectives of Earth from ISAT
Speaker 2: to ISAT, iiO to JEDI, and the future EDGE and
Speaker 2: STV missions. Earth observing lighter capabilities have undergone multiple iterations
Speaker 2: across time, starting with full waveform observations over predominantly water
Speaker 2: and ice landscapes. Full waveform LIGHTAR was then adapted to
Speaker 2: measure vegetation with increased density and resolution. A photon counting
Speaker 2: lighter for ice, water and terrestrial area with iat IW
Speaker 2: also greatly improve the spatial resolution. Features from each of
Speaker 2: these systems have contributed to the design of future missions
Speaker 2: like EDGE who will increase sampling density with additional beams
Speaker 2: and swath mapping for improved change detection capabilities and repeat coverage.
Speaker 2: Now let's dive into section two to overview Jedi's data products,
Speaker 2: including the waveform metrics and estimations and derived products for vegetation, structure,
Speaker 2: and biomass. When JEDI samples data, which occurus milis millions
Speaker 2: of times per week, several data products can be derived.
Speaker 2: The samples are collected as received waveforms, which are geolocated
Speaker 2: to Earth's surface and presented as the Level one B product.
Speaker 2: These waveforms capture the height structure of the surface features
Speaker 2: within the waveform. Several algorithms that are developed by the
Speaker 2: Jedi science team make sense of the waveform shape and
Speaker 2: its intensity based on its geographic location, the land cover type,
Speaker 2: and more to generate each of the other data products.
Speaker 2: These interpretations result in elevation and height data sets for
Speaker 2: bare earth elevation, top canopy height, and relative heights across
Speaker 2: the vertical profile as found in the Level two A product,
Speaker 2: which are footprints, Level three and the other derived products
Speaker 2: aggregate and reformat those elevation and height metrics at different
Speaker 2: resolutions and with certain quality checks applied. Additional measured variables
Speaker 2: for vegetation structure include canopy cover, plant area index, plant
Speaker 2: area volume density, and folio height diversity in the Level
Speaker 2: two B footprint data set. The waveform structural complexity index
Speaker 2: in Level four captures the complexity of the canopy within
Speaker 2: the entire lightar waveform return. Several of these metrics are
Speaker 2: total summaries, or they are calculated across the vertical profile
Speaker 2: along the height of the surface feature. From these different
Speaker 2: types of metrics, biomass can then be modeled either the
Speaker 2: density or the total biomass with associated uncertainty metrics that
Speaker 2: are included in jedi's Level four A footprint and Level
Speaker 2: four B or other derived biomass data products. The footprint
Speaker 2: level data sets are publicly available as HDF five files,
Speaker 2: But what is an HDF five file? These files organize
Speaker 2: data sets of multiple formats into hierarchies or groups along
Speaker 2: alongside their associated metadata. The root group stores all data
Speaker 2: within the file under which additional groups are housed. The
Speaker 2: groups direct to several stored data sets of metrics and
Speaker 2: metadata for each observation. An example of the fire files
Speaker 2: oh my god, Okay, let me repeat that. An example
Speaker 2: of the file structure is shown on the right. The
Speaker 2: level one B waveform, Level two A heights, Level two
Speaker 2: B structure, Level four A biomass, and level four C
Speaker 2: waveform Structural Complexity Index are accessible as HDF five formats.
Speaker 2: To date, opening and handling the HDF five files, including
Speaker 2: converting from HDF five to say CSV, shape file or
Speaker 2: in array, requires either using coding solutions in Python R
Speaker 2: or in Google Earth Engine, and there are some non
Speaker 2: coding oriented existing tools with great visualization capabilities with some
Speaker 2: limitations to data sets available over a certain study area
Speaker 2: with some size constraints. And by the way, the Google
Speaker 2: Earth Engine Jedi FI foot prints are formatted into monthly rosters,
Speaker 2: which is a bit more convenient to use when managing
Speaker 2: the HDF five file itself. Knowing this file structure will
Speaker 2: be really important for opening, subsetting and visualizing the data themselves.
Speaker 2: Each product has a unique setup, so the data dictionaries
Speaker 2: and specific path names become particularly important when working with
Speaker 2: a file. Beam xxxx indicates that the same groups of
Speaker 2: data sets are hosted eight times, meaning that they were
Speaker 2: collected and stored separately by for each beam. For example,
Speaker 2: if you want to find the latitude of the lowest
Speaker 2: mode of the waveform, you'll need to follow the path
Speaker 2: from the root group down to the data set. So
Speaker 2: if you're working with the root group, which would be
Speaker 2: for example, JEDI Level two A, you'll have to navigate
Speaker 2: to one of the beams, say Beam one thousand, then
Speaker 2: go to the geolocation group where the latitude lowest mode
Speaker 2: group is housed and all of the data values for
Speaker 2: each observation are there. If you wanted to get lat
Speaker 2: lowest mode for all of the beams, you'd have to
Speaker 2: select and go through this process eight times. Note that
Speaker 2: programs like RCGIS or QGIS cannot read the Jedi HDF
Speaker 2: five files directly, so they will need to be opened
Speaker 2: or transformed by alternative methods, which we can talk about
Speaker 2: later in this section. So all the other data products
Speaker 2: are provided in a more familiar GEOTIP format. This includes
Speaker 2: the Level three, Level four B and all the other
Speaker 2: gridded or derived products. These, however, may have predetermined quality
Speaker 2: filters and be at lower resolution, but could be more
Speaker 2: accessible and applicable to larger scale studies. Each product will
Speaker 2: include some combination of the listed conventions for identification and
Speaker 2: definition that could be with a particular time period, version number,
Speaker 2: spatial resolution or instrument as listed on the slide. For
Speaker 2: the rest of the section, we will share Jedi products
Speaker 2: reference tables with important information for choosing a Jedi data
Speaker 2: product to work with. For more detailed information on each
Speaker 2: of these products, I encourage you to review the linked
Speaker 2: reference flyers. So the waveforms, as we detailed in Part
Speaker 2: one are the basis for all of the other Jedi
Speaker 2: metrics and estimations. The original transmitted and received waveform data,
Speaker 2: which are shown as TX and RX and not publicly available,
Speaker 2: are geolocated to Earth's surface and made available as a
Speaker 2: Level one B product. We went over how to access
Speaker 2: this in Part one. Level two A is the next
Speaker 2: product level built from those geolocated waveforms. It includes data
Speaker 2: for the detected ground elevation, top canopy height, and relative
Speaker 2: heights along the vertical profiles that are zero to one
Speaker 2: hundred from interpreting the waveform itself with the Level two
Speaker 2: A processing algorithms. The Level three gridded surface metrics pictured
Speaker 2: on the bottom here offers a gridded approach to the
Speaker 2: elevation and height metrics in TIF image format rather than
Speaker 2: as footprints within the one kilometer by one kilometer grids globally,
Speaker 2: the JEDI data footprint counts are recorded within each grid
Speaker 2: to calculate the mean canopy height specifically with R one
Speaker 2: hundred and the mean ground elevation along with the standard
Speaker 2: deviations for each The calculated elevation and height variables are
Speaker 2: produced for a set of five different time periods of
Speaker 2: the mission in order to incorporate more of the footprint
Speaker 2: level data that's been accumulated as the mission continues. Now
Speaker 2: a lot of the other gridded products and derived products
Speaker 2: follow a similar method of aggregating over different time periods
Speaker 2: to generate those data sets. Level two B is also
Speaker 2: based on the geolocated waveform as well as the derived
Speaker 2: elevation and canopy top height from Level to A, but
Speaker 2: it mostly relies on the probability of complete laser penetration
Speaker 2: through the canopy and to the ground. In order to
Speaker 2: accurately calculate the structural metrics. The vegetation metrics from level
Speaker 2: to B are all built off one another along the
Speaker 2: vertical profile of the surface feature, canopy cover and plant
Speaker 2: area index are calculated from the vertical metrics. A total
Speaker 2: value for canopy cover fraction and the total plant area
Speaker 2: index can also be calculated. From those plant area index results.
Speaker 2: The vertical profile plant area of volume density is also calculated,
Speaker 2: and from that the foliage height diversity is derived. Each
Speaker 2: of these data sets offers a unique perspective of the
Speaker 2: vegetation characteristics, though they are closely linked algorithmically. The figure
Speaker 2: shows an example subset of the waveform structural complexity index
Speaker 2: prediction from level four C over the Eastern Amazon. Level
Speaker 2: four C provides an index for the structural complexity of
Speaker 2: the waveform and is estimated with models that are specified
Speaker 2: over four plant functional types. The index values for high
Speaker 2: and low complexity are available as a total for the
Speaker 2: entire footprint or as multiple values along the vertical profile
Speaker 2: like those in Level two B. The index combines the
Speaker 2: information from the vertical and horizontal canopy layers from the
Speaker 2: waveforms in relation to available airborne line or data into
Speaker 2: a single interpretable metric. The figure on the right shows
Speaker 2: above ground biomass density over the US with cloud free
Speaker 2: data from February twenty twenty three. The biomass level data
Speaker 2: sets are available in footprint and gridded formats, offering related
Speaker 2: information at multiple resolutions or aggregated mean over a one
Speaker 2: kilometer grid. The biomass is modeled in each case with
Speaker 2: environmental conditions in mind, such as leaf status whether it's
Speaker 2: leaf on or leaf off depending on the land cover type,
Speaker 2: the plant functional type, and geographic region considered respective to
Speaker 2: the algorithm that's applied to each footprint or guid. Since
Speaker 2: JEDI is a sampling mission and not an imaging or
Speaker 2: wall to wall mapping sensor, many workflows may need to
Speaker 2: combine JEDI with other data to fully map a landscape
Speaker 2: and measure change over time. An example of this is
Speaker 2: in the derived product put out by the JEDI mission.
Speaker 2: In many of the derived products put out by the
Speaker 2: JEDI mission that help increase the quality and density of
Speaker 2: the information. For example, a simultaneous spaceborne light our mission
Speaker 2: is SAT two collects photon point cloud data over vegetation
Speaker 2: in terrestrial areas as well that can be fused with
Speaker 2: JEDI for increasing the three D sampling density and temporal
Speaker 2: coverage of the observations, and it's provided as a fuse
Speaker 2: product at lower resolutions. For select pantropical forests. Shown on
Speaker 2: the leftmost map, height and biomass are calculated with a
Speaker 2: combination of JEDI and InSAR from the TANDEMX mission by
Speaker 2: the European Space Agency. These are tropically optimized wall to
Speaker 2: wall maps of height and biomass information. The figure on
Speaker 2: the bottom left presents canopy height from that TANNEMAX fusion
Speaker 2: over Gabon, Mexico, French Guiana and the Amazon Basin. Two
Speaker 2: other available products from the mission are highlighted here. The
Speaker 2: gridded version of all the Level two B vegetation structure
Speaker 2: metrics are presented at multiple resolutions and have been processed
Speaker 2: with stricter quality filters applied. For example, the mean foliage
Speaker 2: high diversity in the leftmost map was generated with JEDI
Speaker 2: shots acquired between April twenty nineteen to March twenty twenty
Speaker 2: three and aggregated in six kilometer grid cells. The Level
Speaker 2: four B country level summaries for above ground biomass are
Speaker 2: also completed at multiple time periods throughout the Jedi emission
Speaker 2: to help countries meet reporting standards. The figure on the
Speaker 2: right demonstrates country wide estimates of total above ground biomass
Speaker 2: in pedagrams created using the level four two point one version.
Speaker 2: This data set also includes biomass estimated by FAO for comparison.
Speaker 2: More details on how these metrics and data sets are
Speaker 2: calculated or derived will not be reviewed in this training,
Speaker 2: but there are additional trainings and resources in the NASA dacks.
Speaker 2: You can reference the data dictionaries, the algorithm theoretical based documents,
Speaker 2: or reference some additional trainings like the one we'll discuss
Speaker 2: at the end by NASA earth Rise for data preparation
Speaker 2: techniques for applied users and will that will dive into
Speaker 2: section three to discuss resources and tools for accessing, visualizing,
Speaker 2: and analyzing JEDI data products. So there are many considerations
Speaker 2: when choosing a data product to work with. Of course,
Speaker 2: as previously mentioned, ensuring the coverage and spatial and tempore
Speaker 2: resolution is primary. Your choice in using Jedi may depend
Speaker 2: on those mission specifications that we showed earlier. If you're
Speaker 2: looking to select data from specific timestamps. You may need
Speaker 2: to work with the footprint level samples since the gridded
Speaker 2: or other derived products aggregate annually or over larger time
Speaker 2: periods across the lifetime of the JEDI mission. Working with
Speaker 2: the footprint level data sets will be at twenty five
Speaker 2: meter resolution, which could be useful for localized applications or
Speaker 2: for use as calibration and validation or as training data themselves. However,
Speaker 2: these data sets are not represented analysis ready. This means
Speaker 2: that the user will need to deploy footprint level specific
Speaker 2: means of access, preparation and visualization strategies to work with
Speaker 2: the files, and will go over some open source tools
Speaker 2: and a demonstration with a Python notebook to exemplify this.
Speaker 2: If you are applying to a landscape, country, regional, or
Speaker 2: global scale application, using the gridded or derived products that
Speaker 2: are already quality filtered and aggregated over certain time periods
Speaker 2: could be really flexible options. These data sets are easy
Speaker 2: to work with since they're in GEOTIPH, but it's recommended
Speaker 2: to refer to the data preparation descriptions in order to
Speaker 2: better understand the assumptions that were made when generating those
Speaker 2: derived data sets and review whether those assumptions are optimal
Speaker 2: for your particular ecosystem's characteristics. So this reference table can
Speaker 2: be used to help you decide on how to handle
Speaker 2: your desired Jedi data product. So we will review the
Speaker 2: Earth Data Guy, tes Viz, slide rule, and Harmony Api
Speaker 2: in part two, while part three will review accessing Jedi
Speaker 2: data sets and Google Earth Engine, and the rest of
Speaker 2: the options are up here for your exploration. So the
Speaker 2: takeaway here is that not every product is available for
Speaker 2: as access or able to be processed across every platform.
Speaker 2: Some platforms like Earth Data Search are really only for
Speaker 2: data access and basic boundary overlap or temporal filtering, while
Speaker 2: platforms like tesviz, the Harmony API, slide rule client go
Speaker 2: beyond access and allow for more customized data processing, download, formatting,
Speaker 2: and visualization. For the greatest customization capabilities over large study areas,
Speaker 2: the user may need to deploy programming oriented approaches, especially
Speaker 2: when handling the footprint data. So platforms like and other
Speaker 2: packages in our Jedi Google Earth Engine or other Python
Speaker 2: workarounds like JEDIDB and other ones that will present in
Speaker 2: our demonstration today are good options that can enable you
Speaker 2: to have within platform data storage processing or link to
Speaker 2: other APIs or platforms. Any Jedi data product can be
Speaker 2: accessed via the Earth Data Search. It can be single
Speaker 2: download or bulk or cloud optimized methods. There are already
Speaker 2: many tutorials that exist to help you navigate the Earth
Speaker 2: Data system and interface that we will not replicate here today,
Speaker 2: and the same goes for coding related bulk access with
Speaker 2: the LP and ournl dax that provide command line and
Speaker 2: Python based guides to download from the catalog. With specific
Speaker 2: spatial and temporal subsetting linked here, you can acquire the
Speaker 2: footprints and download the HDF five files that roughly overlap
Speaker 2: with your location in time period from Earth Data Search,
Speaker 2: but further spatial clipping, variable subsetting, and any type of
Speaker 2: processing that will need to be done would have to
Speaker 2: be done on an alternative platform once you've acquired those
Speaker 2: files from the platform. So let's take a quick look
Speaker 2: at how the Jedi data products show up on the
Speaker 2: Earth Data Search interface. On the top left I typed
Speaker 2: Jedi into the search bar to get all the possible
Speaker 2: data product collections available to be filtered by the temporal
Speaker 2: and spatial extent specifications on the top left panel. There
Speaker 2: are the main options for temporal and spatial filtering. This
Speaker 2: is what controls the search results of the data products
Speaker 2: that can then be further opened or visualized. The geotips
Speaker 2: and HGF five products that will meet the filter criteria
Speaker 2: will appear and you can download the data. They might
Speaker 2: not be necessarily clipped or subset to the exact spatial
Speaker 2: extent we defined here with the polygon tool, so you
Speaker 2: input the time period, use the polygon tool to get
Speaker 2: a rough area of interest and as you can see,
Speaker 2: the entire swath, which includes the trajectories of all the
Speaker 2: eight of the beams are shown overlapping with the study area.
Speaker 2: The individual beams and samples are not visualized here. You
Speaker 2: can highlight the overlapping orbit to see its location and
Speaker 2: download the h five file for example. Other tutorials can
Speaker 2: go over AWS access for bulk download. But the level
Speaker 2: two B and Level four A, Level one B and
Speaker 2: Level four C waveform footprint products, so basically all the
Speaker 2: HDA five data sets show up in the same way
Speaker 2: where you're just seeing the outline and going back to
Speaker 2: the main results. Level three gridded elevation and height metric
Speaker 2: are actually visualized on the map where you can see
Speaker 2: the values and the spatial extents of each of those
Speaker 2: grids with a particular color legend and can be downloaded
Speaker 2: in a similar way. The Level four B biomass data
Speaker 2: values are also conveniently visualized with the color scheme and
Speaker 2: demonstrated with the grids. Some of the derived products are
Speaker 2: global TIFFs and will have associated p and gs for
Speaker 2: your convenience to visualize the data set, but other products
Speaker 2: the data will have to be downloaded to properly visualize.
Speaker 2: So for here we see the outline, the global outline
Speaker 2: of the data set, but there's no visualization. When we
Speaker 2: zoom back in we see that it just highlights that
Speaker 2: it overlaps. The Terrestrial Ecology Subsetting and Visualization Services platform
Speaker 2: is exclusively for the Level three gridded Height and Biomass
Speaker 2: and Level four A and Level four B biomass products.
Speaker 2: You can use this platform for acquiring data from conveniently
Speaker 2: pre processed locations or use the API tool for customization
Speaker 2: or subset by a user defined location. So let's walk
Speaker 2: through how to select a location for data processing of,
Speaker 2: for example, the gridded Level three product. Though you can
Speaker 2: acquire the prepared data sets or use the web service tool.
Speaker 2: We are going to demonstrate the user defined subsets tool.
Speaker 2: From here, you can define a location point or customize
Speaker 2: by manual input to grab generally overlapping data. This could
Speaker 2: pose an issue if you're looking to a subset by
Speaker 2: larger areas. Scrolling down the sensor and the data product
Speaker 2: can be selected. You can select multiple products at a
Speaker 2: time or type them in. You can also select specific
Speaker 2: variables if you desire. The next step is to input
Speaker 2: the desired time period to filter by, followed by optionally
Speaker 2: choosing to generate geotifs and choose between the projections. The
Speaker 2: data requests will be submitted and take some time to
Speaker 2: deliver depending on the demand of the request. The resulting
Speaker 2: subset data sets get sent to your email. When they
Speaker 2: are ready for download in multiple formats, the user is
Speaker 2: directed to a temporary page where the data in multiple
Speaker 2: formats can be downloaded. The order summary is also available
Speaker 2: with auxiliary maps and statistical summaries for modus and land
Speaker 2: cover and phonology, and other resources for visualization, as well
Speaker 2: as some statistics. In addition, the citation is generated and
Speaker 2: the location, subset and projection are summarized. If you wish
Speaker 2: to download the data. You can click the link and
Speaker 2: a local directory page pops up to save the files
Speaker 2: on your local computer. The same process can be applied
Speaker 2: to each of the available download links. Here you can
Speaker 2: see that each of the bands are available separately and
Speaker 2: in multiple formats like GEOTIP or as CSVS. Finally, the
Speaker 2: visualization tool can be accessed under the tab for order summary.
Speaker 2: From here you can run the visualization where each band
Speaker 2: from the Level three data set is visualized in a
Speaker 2: uniform way and a comparative table, so with the same
Speaker 2: color scheme you're getting each of those bands for the
Speaker 2: Level three product and statistics associated. Next, we have slide
Speaker 2: real client. It's a platform made in collaboration with the
Speaker 2: University of Washington and NASA Goddard's Face Flight Center. It's
Speaker 2: an open source framework for on demand processing of science
Speaker 2: data in the cloud with AWS. It also has access
Speaker 2: to ISAT two, Jedi, Lancelot, Arctic deem Rima, and a
Speaker 2: growing list of other data sets that are stored in
Speaker 2: AWSS three. This solution includes an API for customization and
Speaker 2: is well documented. Customizing the API may allow for more
Speaker 2: flexible use over larger areas, but this user interface tool
Speaker 2: that will go over today. Is also built for the
Speaker 2: ISAD data sets, which is a plus if you're looking
Speaker 2: to fuse these data sets in your application, but it
Speaker 2: is currently only developed for three of the footprint level
Speaker 2: data sets, which includes the Level one B waveform, Level
Speaker 2: two A heights, and Level four A biomass data. Let's
Speaker 2: take a look at how to interact with JEDI data
Speaker 2: using slide roll clients functionalities on the left panel, the
Speaker 2: user can select the data set they would like to visualize,
Speaker 2: process and download one at a time. On the map,
Speaker 2: use the polygon tool to define a relatively small study
Speaker 2: area to work with. This can be a limitation for
Speaker 2: users looking to use slide roll for larger studies. I
Speaker 2: can check the request parameters on the top left and
Speaker 2: using the advanced settings, additional parameters to what is predetermined
Speaker 2: for the selected data set can be applied. You can
Speaker 2: control timeout checks, select specific data variables, only specific beams
Speaker 2: or quality flags that you'd like to include in the
Speaker 2: final data set. And there's another parameter for data sets
Speaker 2: that we won't use. And as you can see, the
Speaker 2: request parameters are updated with these customizations. You click run
Speaker 2: to process the data. You may take a little while
Speaker 2: and then the user will be automatically directed to additional
Speaker 2: processing and visualization tools once the acquisition is run. There's
Speaker 2: a map that visualizes the beam transects and has advanced
Speaker 2: filter controls that allow you to specialize the visualization layers
Speaker 2: by individual beams, ground tracks, or select a particular orbital path.
Speaker 2: The map plotting can also be controlled where the data
Speaker 2: values for each of the shown attributes get displayed. When
Speaker 2: you hover over the data point, the user can interact
Speaker 2: with the map and retrieve the data values for every
Speaker 2: included JEDI variable. Next, the right most feature generates an
Speaker 2: elevation plotter for the data along the latitude. This is
Speaker 2: most relevant for the elevation and high products. There is
Speaker 2: also a three D viewer that displays the values along
Speaker 2: the latitude and longitude with a particular legend to demonstrate
Speaker 2: the range along the z access and then much of
Speaker 2: the parameters below are to control the interactive three D visualizations.
Speaker 2: Mostly Finally, there is a table tab that allows you
Speaker 2: to run an SQI querry to visualize the data sets
Speaker 2: that can be exported as a CSV. Okay, so now
Speaker 2: for our demonstration, we'll give an example of how to
Speaker 2: use the Harmony API, there's going to be a focus
Speaker 2: on accessing, downloading, visualizing, and analyzing the footprint level data.
Speaker 2: So really the question that we're trying to address is
Speaker 2: what do you do once you have the hd of
Speaker 2: five files in you know, whatever format that you selected,
Speaker 2: If you want to work with a larger area or
Speaker 2: specify with a particular shape file, you know, how can
Speaker 2: you do that? So when you download the h five
Speaker 2: files from Earth Data Access, they're not necessarily clipped directly
Speaker 2: to your spatial extent. So this solution will help you
Speaker 2: do that when you download the file. It also includes
Speaker 2: all of the variables that could be hundreds of variables,
Speaker 2: most of those you do not need. Maybe you want
Speaker 2: a handful about twenty two recommended So how can you
Speaker 2: down select those from the HDF five and then transform
Speaker 2: that data into a preferred format something that's maybe more
Speaker 2: compatible across multiple geospatial platforms like a shape file or
Speaker 2: a CSV. And just to know that Harmony API works
Speaker 2: with all of the waveform data. So that's level one
Speaker 2: B to A to B, level four A and four C.
Speaker 2: And so what you'll need is the NASA Earth Data
Speaker 2: Access account, the Google Drive account as well, when you'll
Speaker 2: need your credentials for the Earth Data Access ready to
Speaker 2: plug into the script and access to Google Collab. So
Speaker 2: this Python notebook will demonstrate how to download the data,
Speaker 2: select certain variables to subset that you'll want to analyze,
Speaker 2: generate some statistics and visualizations. We're going to use two
Speaker 2: example study areas. One of them is of Pinon Pine
Speaker 2: Forge around Albuquerque, New Mexico, as well as a paint
Speaker 2: Rock research forest in North Alabama, which is part of
Speaker 2: the geotrees Field Data Network and is largely managed by
Speaker 2: Alabama A and M University. So just as for your
Speaker 2: awareness the Google Collab notebook, if you do command or
Speaker 2: control question mark if you're looking to customize a notebook
Speaker 2: and plug in your own AOI or change the data products.
Speaker 2: So we'll be using an example with level two B
Speaker 2: vegetation structure. If you wanted to look at level one
Speaker 2: A or look at four A for biomass, you can
Speaker 2: command search for the question marks and follow the input
Speaker 2: prompts throughout the demonstration. Okay, so when you click the link,
Speaker 2: it will take you to this GitHub repot for our
Speaker 2: said too. This is where our script is held. The tutorial.
Speaker 2: There's a little read me here that gives an overview
Speaker 2: of what we'll be doing. So you're going to search
Speaker 2: and retrieve the Jedi footprints over particular areas of interest.
Speaker 2: You're going to filter them by specific metrics and other
Speaker 2: important variables which we'll talk a little bit about. We'll
Speaker 2: be able to visualize them with different figures, get some
Speaker 2: statistics as well as some three dimensional figures. You can
Speaker 2: export them as a CSV or a shape file, and
Speaker 2: everything is run in the Jupiter notebooks, so there's no
Speaker 2: set up on your local computer required. And just for
Speaker 2: a quick overview, this is all the steps that we'll
Speaker 2: be doing within the script. So we'll set up our
Speaker 2: environment by getting our libraries with PIP and stall import
Speaker 2: our core dependencies. Set up some directories, so that's using
Speaker 2: the temporary space which is housed here on the little
Speaker 2: folder tab that when you're connected to the run time,
Speaker 2: you're able to save all your files. Here. We'll get
Speaker 2: access to the NASA Harmony API capabilities. We'll set up
Speaker 2: our study area and I'll show you a couple ways
Speaker 2: to connect your study area data, establish your temporal period
Speaker 2: to filter Jedi by, and then we'll go ahead and
Speaker 2: execute the downloading the hd of five files with the
Speaker 2: Harmony API. But when you download those files, you're going
Speaker 2: to get a bunch of data that you probably don't want.
Speaker 2: There's in some of them hundreds of variables that you're
Speaker 2: probably not going to use, and we list the about
Speaker 2: twenty two recommended and not varies depending on the level product.
Speaker 2: So we're going to be looking at level two B
Speaker 2: the vegetation structure metrics, and we'll go ahead and subset
Speaker 2: the files greatly reduce how much data is being stored,
Speaker 2: which will really help with computation and when you're working
Speaker 2: within in other platforms. We'll take a quick look at
Speaker 2: those files to make sure that everything was good with them,
Speaker 2: and also just to demonstrate how to open the HDF
Speaker 2: five file in the Collab notebook, convert them to a
Speaker 2: geodata frame which is usable within the Jupiter Notebook in
Speaker 2: that temporary computational space, and then offer some options to
Speaker 2: export it to your drive as a shape file or
Speaker 2: a CSV. We'll talk a little bit about some quality
Speaker 2: filtering techniques that we're discussed in Part one, but if
Speaker 2: you would really like to go more in depth on
Speaker 2: preparing the data with more application specifications, in mind. The
Speaker 2: repo that this is housed in is a training that
Speaker 2: goes more in depth on that, and so there's several
Speaker 2: modules that talk a lot more about application specific. Quality
Speaker 2: filtering will just be applying a couple which includes getting
Speaker 2: rid of no data values and seeing how that changes
Speaker 2: the data set. We'll map those and take a look
Speaker 2: at what the data that looks like before and after
Speaker 2: that quality filtering, we'll do some basic statistics on counting
Speaker 2: the observations per year over the study area and generate
Speaker 2: our final filtered data set. We'll go ahead and plot
Speaker 2: and explore the data sets, so we'll have some violin
Speaker 2: plots that look at each variable from the vegetation structure
Speaker 2: metrics per year per study area, generate a pair plot
Speaker 2: that will show some relationships between those available data sets,
Speaker 2: and generate some three D visualizations. So when you're here,
Speaker 2: you have a couple options to access the file. So
Speaker 2: you can click this tab here and that will bring
Speaker 2: you to the script that you can run. So I'll
Speaker 2: open then in a new tab. Just for reference, you
Speaker 2: can go to the file itself here and click download.
Speaker 2: That's just a GitHub error that they're still fixing, but
Speaker 2: it's still a valid data script, so you can download
Speaker 2: it and then up load it to your Google Drive
Speaker 2: or Another neat trick is when you're open to this file,
Speaker 2: you can hit two colm right after GitHub and you'll
Speaker 2: see that the icon changes. Hit enter, and then you're
Speaker 2: taken to the script as well. So when you get
Speaker 2: to this area, you're probably going to need to connect here,
Speaker 2: so you hit connect and it'll set up. And just
Speaker 2: two important tabs here to note are this table of contents,
Speaker 2: which is essentially that outline that I just went over,
Speaker 2: which when you click somewhere it jumps you to the
Speaker 2: section where you can start executing code, and the folder here.
Speaker 2: So this when you don't have it connected, will not
Speaker 2: have these two folders. You'll just be connected to this
Speaker 2: temporary space as you can see here in this disc
Speaker 2: This is what you're computing under. But I'll show you
Speaker 2: when we start off, we connect to your drive, so
Speaker 2: here is your personal drive that you can and connect
Speaker 2: to data or upload data sets to, which will show.
Speaker 2: And then when you connect to the temporary space and
Speaker 2: we start running through the code, it will generate this
Speaker 2: folder here that only exists in this when you're working
Speaker 2: through this script live. So when you start, we have
Speaker 2: again a little overview and just a note here, so
Speaker 2: you can follow along with this script and run sell
Speaker 2: by sell. That's just kind of at your own pace.
Speaker 2: But you can also hit run all and follow the
Speaker 2: input prompts which will show in this tutorial in order
Speaker 2: to run through what's written in this script. If you
Speaker 2: want to do further customization and change, so we're working
Speaker 2: with level two B. If you want to go to
Speaker 2: level two A, level one B, level four A biomass,
Speaker 2: you will be prompted to input certain variables and or
Speaker 2: you can search, so you can do command F for
Speaker 2: a question mark and you'll see all of these areas
Speaker 2: here where you might want to customize. So, oh, I
Speaker 2: want to work with level two A instead, that's somewhere
Speaker 2: where I would type in the code to change that.
Speaker 2: If you want to input a different AOI and say
Speaker 2: you're working California or something like that, you would need
Speaker 2: to rename these And just for the sake of how
Speaker 2: this tutorial is written, if you want to customize it,
Speaker 2: it is written in dictionaries, so it's going to iterate
Speaker 2: over multiple aois, so just a reference on you'll have
Speaker 2: to modify some of the script if you want to
Speaker 2: look at just one area. So that's just a little
Speaker 2: thing to work around. So when you start, you can
Speaker 2: either hit run all follow the inputs, or go sell
Speaker 2: by Sell. Here, we're going to go sell by Sell.
Speaker 2: So to set up your collab, you're going to install,
Speaker 2: So I'm actually gonna head over to some pre run
Speaker 2: code here. It should take in total about thirty minutes
Speaker 2: to run the whole thing, depending on the size of
Speaker 2: your AOI, which isn't too bad. So when you do
Speaker 2: pip install, you get a bunch of these prompts. It
Speaker 2: may prompt you to restart the session. You don't need
Speaker 2: to do that. You can click cancel and as long
Speaker 2: as this green check mark comes up, you're good to go.
Speaker 2: And then from here you want to mount your drive.
Speaker 2: So when you mount your drive, a pop up will
Speaker 2: come up and it'll ask you to put in your
Speaker 2: Google Drive credentials, just like you're signing in to your
Speaker 2: email or whatnot, and then the folder will pop up
Speaker 2: here like I showed, where you can access all of
Speaker 2: your content. Now we're going to establish the directories. That
Speaker 2: is how we're going to save data and locate to
Speaker 2: our aois. So you can add more aois if you wanted. Again,
Speaker 2: be careful with some size. It's not unlimited. But if
Speaker 2: you're working with a product, you want to make sure
Speaker 2: that this variable is changed and make sure that your
Speaker 2: ais are set. So you can just click run for that.
Speaker 2: And I put some directions here on just clicking run,
Speaker 2: which means that it's just kind of automated. Everything is
Speaker 2: connected to the variables that you change, so you can
Speaker 2: just go ahead and click. And this sets the folders
Speaker 2: where everything is located. So you have paint Rock that's
Speaker 2: within that main directory and pinon. So we create this
Speaker 2: base path that we then change our directory to. So
Speaker 2: this is just telling our code, hey, we want to
Speaker 2: work out of this main folder, not anything else. So
Speaker 2: that helps us execute all of our code. And this
Speaker 2: may take a little while when you run the required packages.
Speaker 2: So we need all of these to plot, to use
Speaker 2: the widgets to map, to get Earth data access, to
Speaker 2: get Harmony, all that kind of stuff, and then we're
Speaker 2: ready for step two. So here this is where you're
Speaker 2: gonna need your credentials for Earth Data access. We're gonna
Speaker 2: basically set up the request for Harmony API, set up
Speaker 2: all of the requirements to make that call to Harmony
Speaker 2: to get the data. So first we need to input
Speaker 2: our credentials here and it'll prompt you with an enter
Speaker 2: to enter your your user name and your password this
Speaker 2: was also shown in part one. And then we go
Speaker 2: ahead and actually use that password to authenticate and connect
Speaker 2: to Harmony client. I might take a little moment, and
Speaker 2: then from here, this is where we define the Jedi
Speaker 2: product that we want to use. So when you hit
Speaker 2: this code, it'll ask you to enter something and so
Speaker 2: Harmony works with all the footprint level data. We're going
Speaker 2: to be working with Jedi two B, so you can
Speaker 2: either type it or copy it. So if you were
Speaker 2: plugging in another data set, you would copy any of
Speaker 2: these other names here and hit enter and there you go.
Speaker 2: So from here we want to make sure that the
Speaker 2: Harmony client is actually accessing the variables and all of
Speaker 2: the capabilities specific to the Jedi product that we just defined.
Speaker 2: So when you run that, it allows you to see
Speaker 2: that oh great. So for each beam this variable in
Speaker 2: RX processing called shot number, I'm able to access it.
Speaker 2: And so you see there's hundreds of different variables which
Speaker 2: we will show you how to choose from and get
Speaker 2: So now we go ahead and get the collection ID.
Speaker 2: This is what's going to be used in the Harmony
Speaker 2: API request. So really we're just telling it to give
Speaker 2: us these in a variable that we input later. I
Speaker 2: want to set up a variable that allows us to
Speaker 2: connect to the path, the area, the folder that is
Speaker 2: connected to our AOI that will use in the later functions. Again,
Speaker 2: when you change these above, these should change if you're
Speaker 2: plugging in your own AOI, and now we want to
Speaker 2: import our AOI data, So this is you're going to
Speaker 2: have to have them in geojason format, so that's quite important.
Speaker 2: What we're using here is the gethub a git hub geojason,
Speaker 2: so you can do this as well in your own repo.
Speaker 2: You would be able to upload wherever. It doesn't have
Speaker 2: to be in the same exact folder, but you could
Speaker 2: upload a GeoJSON. You go ahead and click it and
Speaker 2: get hub is this nice thing where you can visualize.
Speaker 2: But you want to click raw over here, which gives
Speaker 2: you the raw file and then you just copy this
Speaker 2: you here and paste it into your code here. So
Speaker 2: for here, we're just using what's openly available in our
Speaker 2: own rebel, so you can run through this tutorial, but
Speaker 2: you can change that yourself, or you can connect to
Speaker 2: a geodjason that is located in your own drive. So
Speaker 2: a new trick here is when you connect to drive
Speaker 2: and let's say I just pick a random I'll just
Speaker 2: pick a random file here. So say we are looking
Speaker 2: at this video and we want to copy the path here,
Speaker 2: So we click those three dots copy the path. That's
Speaker 2: what gives us this path right here. You would paste that,
Speaker 2: you would need to uncomment, so you would need to
Speaker 2: get rid of these hashtags in front. If you were
Speaker 2: to run with the plugging in your AOI to the
Speaker 2: drive instead, and that should work. Then you go over
Speaker 2: here and you want to convert those geojasons into a
Speaker 2: geodata frame. So that's basically just reading the file in
Speaker 2: this collab notebook. So when we do that, it makes
Speaker 2: it available to be mapped. And so we click this
Speaker 2: here too, and it'll display your AOI sites. So we're
Speaker 2: looking at pinon pine forage areas, so really yummy pine
Speaker 2: nuts here outside of Albuquerque, New Mexico. So that's quite
Speaker 2: a large area. And then we're looking at a very
Speaker 2: small area of a conservation forest here in northern Alabama.
Speaker 2: Not much has happened here, not much you know, in
Speaker 2: any logging fires and what have you. Super beautiful site.
Speaker 2: So those are what it's great we have those aois.
Speaker 2: They look great. And notice that, well this one was
Speaker 2: a rectangle, but this one had as a more complex polygon.
Speaker 2: So you're able to upload your GeoJSON that's more complex.
Speaker 2: But when you actually run the Harmony API, it takes
Speaker 2: a bounding box, so you may need to clip your
Speaker 2: data afterward in a different like within collab or whatever
Speaker 2: platform you're comfortable with. But when it makes the request
Speaker 2: to NASA the DAS, it needs just a really simple polygon.
Speaker 2: So this is what's taking the shape file that you
Speaker 2: input and making a box around that instead of using
Speaker 2: a complex polygon. Then we define these this variable that
Speaker 2: is just configuring the names of the sites that we're
Speaker 2: using for the AOI bounding boxes that we've created to
Speaker 2: the folder that it's housed in. So that's over here.
Speaker 2: These folders to help us with later functions. So now
Speaker 2: we've established AOI, So where are we here? So we've
Speaker 2: gone through and we've gotten Harmony. We've defined our Jedi product,
Speaker 2: we've defined our aois. Now we want to establish our
Speaker 2: temporal filter. So remember just a render here. This is
Speaker 2: when the data is available, and you're gonna get to
Speaker 2: input that yourself. So here, when you run this, it
Speaker 2: will allow you to hit enter. So I'm gonna try
Speaker 2: this over here just so I don't okay, So we
Speaker 2: can hit enter here and we can type in two
Speaker 2: January first hit enter, then we can do to the
Speaker 2: end of the year. Let's see that you don't have
Speaker 2: to use the zeros in front it. It takes regular
Speaker 2: single digit numbers as well, so you can have this
Speaker 2: enter or if you want just for something static, you
Speaker 2: can uncomment this and use a static variable. So now
Speaker 2: we're going to actually prepare for downloading the data with
Speaker 2: the Harmony and API and request it. So we're just
Speaker 2: going to define some tracking functions that you'll see in
Speaker 2: the code that's printed out. These are really helpful for
Speaker 2: understanding the size of the data. You know, how many
Speaker 2: files did you download, and you know, just other tracking information,
Speaker 2: how long did it take things like that, and so
Speaker 2: we'll run this download script. This can take a while
Speaker 2: sometimes if I did the whole time period here, the
Speaker 2: whole time period of all the data that's available as
Speaker 2: you can see for the most part, and it takes
Speaker 2: about ten minutes to run over these aois that can
Speaker 2: differ by the size of your AOI as well, so
Speaker 2: you don't need to know much about this code. But
Speaker 2: I did just want to show what the actual Harmony
Speaker 2: API request looks like. So remember, we define our concept ID,
Speaker 2: so that's what's specific to our level to be product.
Speaker 2: Then we have our bounding box and this is our
Speaker 2: dictionary of data day that we input for our two aois,
Speaker 2: and then we've defined our temporal range and so that's
Speaker 2: what's actually getting the file. So there's no variable subset.
Speaker 2: You can do variable subset with Harmony and I, you know,
Speaker 2: refer you to the documentation to do that. The reason
Speaker 2: why we chose this alternative is because there were really
Speaker 2: big limitations on the size of the AOI that you
Speaker 2: can use, and we wanted to enable a solution that
Speaker 2: would allow us to look at a larger area or
Speaker 2: look at multiple areas to compare over any time period
Speaker 2: that we'd like. There are still limitations here. You can't
Speaker 2: do the whole globe, you can't do a whole country
Speaker 2: that you would have to customize coding for. But it's
Speaker 2: a lot more flexible than having Harmony itself parsed through
Speaker 2: the HGA five files to get the specific variables. So
Speaker 2: instead we download the files in the temporary space and
Speaker 2: not onto your local folder and then move on to
Speaker 2: step three to actually subset the data to the variables
Speaker 2: we want. And so here this is what it looks like.
Speaker 2: It's a lot of coding, but it reminds you of
Speaker 2: what your temporal range is. It lets you know which
Speaker 2: AOI it's working on, where it's at. You know, is
Speaker 2: what's the percentage of processing that it goes through. And
Speaker 2: then it actually lists out all of the files that
Speaker 2: it downloaded successfully, and it does that for both of
Speaker 2: the aois, and then at the end you get a
Speaker 2: nice summary of how many aois were processed, how many
Speaker 2: raw files were there was gigabytes, and the average size
Speaker 2: per the files that you understand what's going on and
Speaker 2: where they're located. So you see, wow, the Pinon area
Speaker 2: we knew it was larger and had one hundred and
Speaker 2: six files. Paint Rock only had six files, even though
Speaker 2: we're looking at the whole range of years in twenty
Speaker 2: nineteen to twenty twenty five. So I wanted to show
Speaker 2: these really big differences, and we'll see that throughout the figures.
Speaker 2: You can have you know, Jedi. You could be wanting
Speaker 2: to use Jedi over an area, but it really depends
Speaker 2: on what your area looks like and how Jedi happens
Speaker 2: to collect over that region. So now we're going to
Speaker 2: move on to actually subsetting these variables. So we don't want,
Speaker 2: you know, six gigabytes of data, and we don't need
Speaker 2: all of those. We don't need hundreds of variables. So
Speaker 2: from here we're going to use this text file. This
Speaker 2: is located in the repo that I showed before. It's
Speaker 2: basically just a text file of all of the variables.
Speaker 2: It's like a dictionary of all of the variables that
Speaker 2: are available in the Level two products. So you can
Speaker 2: see hundreds and hundreds of variables, and we don't need
Speaker 2: all those. So we're going to use this text file
Speaker 2: that will just load in by running this code and
Speaker 2: see here, Great, it gets all the data in order
Speaker 2: to then plug in. Hey, I only want Level to
Speaker 2: BE data from this, so this will prompt us to
Speaker 2: put in and from here you can I'm working with
Speaker 2: a level to be, so I can copy this or
Speaker 2: you put in the product that you're working with, enter
Speaker 2: it here, great, and then it gets me only the
Speaker 2: variables that are available for that product. That's still many
Speaker 2: more than I might need depending on my application and
Speaker 2: what I'm doing, the research that I'm doing, and so
Speaker 2: from here we actually want to select those variables. So
Speaker 2: what's important about this list here and you can also
Speaker 2: visit the NASA Data dictionaries, is that we need this
Speaker 2: full filepath name. So even if I just want to
Speaker 2: get the leaf off flag, I can't just type leaf off.
Speaker 2: I need the folder or the group that it's in
Speaker 2: in the HDA five file. So this changes across the product.
Speaker 2: So that's why this step of visualizing and getting all
Speaker 2: of the data or looking at the NASUB Data dictionary
Speaker 2: is really important to get what that real total value is.
Speaker 2: So I want latitude of the highest return, well, it
Speaker 2: needs to be written as if it's from the geolocation folder.
Speaker 2: So from here this is going to ask you to input.
Speaker 2: You can either enter or you can uncomment here and
Speaker 2: create this list yourself, depending on the product. So something
Speaker 2: to notice, because we're working with Level two B, these
Speaker 2: products are specific to level to be for the most part,
Speaker 2: and these ones are just we recommend these. These are
Speaker 2: pretty commonly used if you're working with any Jedi data
Speaker 2: set that are important for quality filtering, for getting your
Speaker 2: location coordinates, for being able to understand the behavior or
Speaker 2: penetrative ability of each of the shots. So I highly
Speaker 2: recommend keeping these, although the prefixes might be different, so
Speaker 2: in like a different product, you know, maybe the degrade
Speaker 2: flag is in a different path folder here, might not
Speaker 2: be in geolocation, might be somewhere else, so you might
Speaker 2: need to double check that with when you're changing your
Speaker 2: folder to that. And so from here, I'm just I
Speaker 2: already wrote this out. So you just have the full
Speaker 2: path names separated by commas in a space, copy that
Speaker 2: and input it into your enter here. Or you can
Speaker 2: put a bunch of apostrophes like this and use this
Speaker 2: variable instead. So great, it loaded those in and it
Speaker 2: formatted it the way that it needs to be. And
Speaker 2: now we're going to define some functions and help us
Speaker 2: select the variable itself. So you just click run here
Speaker 2: to subset. Now you can also specify how many beams
Speaker 2: that you want, So again, subsetting the variables and by
Speaker 2: beams is something that's available in Harmony API, but it
Speaker 2: greatly reduces your computational ability, so we're doing it here
Speaker 2: post download. So a really common thing to do is
Speaker 2: to use only the power beams. So power means that
Speaker 2: the laser is that full power. Coverage means it was
Speaker 2: about reduced to about half of the amount of power,
Speaker 2: which means that maybe it wasn't able to penetrate denser
Speaker 2: forests all the way through. That depends on the AOI,
Speaker 2: and a lot of people are still researching that. So
Speaker 2: if you want to include all the beams and look
Speaker 2: at a comparison, and we'll show you a little bit
Speaker 2: of how to do that, that could be really really interesting.
Speaker 2: Or if you already know that you're working in a
Speaker 2: really dense tropical forest or something like that, you should
Speaker 2: probably just use the power beam. You can just select
Speaker 2: these four beams instead. But for this we want to
Speaker 2: look at all of them because I know that we
Speaker 2: don't have as dense forests in the US, and I
Speaker 2: would like the ability to compare them if I really
Speaker 2: wanted to. And also, when you separate those beams, you're
Speaker 2: greatly reducing the amount of data that you have available,
Speaker 2: and as you'll see, that can be a huge barrier
Speaker 2: to using Jedi. When you actually apply these quality filters,
Speaker 2: how much data is left. So now we're going to
Speaker 2: find some helper functions to actually download the HDA five file.
Speaker 2: So we'll just click run on these. They're just some
Speaker 2: functions that help us do stuff. And this is just
Speaker 2: basically opening the HDF five file, getting the data sets,
Speaker 2: putting them in the right place in the right order,
Speaker 2: reformatting them into the way that we want, and then
Speaker 2: we'll execute that function here. So you just click run
Speaker 2: on all of these, and what it'll look like is
Speaker 2: so I have it print out each of these things
Speaker 2: just to keep track of what's going on. So for
Speaker 2: paint Rock, AI are really small AOI we're making. We're
Speaker 2: creating a folder that's going to be our raw downloads,
Speaker 2: or where we're getting the raw downloads from is from
Speaker 2: this folder. But we're going to create a new folder
Speaker 2: that's for variables selected. And actually you could see that here.
Speaker 2: So we're in paint Rock Great, we created a folder
Speaker 2: here where we got all of our subset variables in.
Speaker 2: So as we do that, we're opening each of those
Speaker 2: files and it's you know, going through and finding each
Speaker 2: of the twenty two variables that we specified from each
Speaker 2: of the eight beams that we want and processes each
Speaker 2: file so it find defines these summaries of how many
Speaker 2: variables we're getting. But from this first file that we
Speaker 2: see here this from twenty to twenty two whatever, you
Speaker 2: see that there's no beams here, so it's skipping them
Speaker 2: and that's just because of the spatial clipping that we got.
Speaker 2: So even if you had the full file available, because
Speaker 2: of the spatial subset, it did not include all of
Speaker 2: the beams. So even though you're requesting for all the
Speaker 2: beams to be selected, that may not be the case
Speaker 2: depending on where they fall over the earth and over
Speaker 2: your shape all that you defined. So this is where
Speaker 2: we really get into and something that you know earth data.
Speaker 2: And until you convert the HDA five into something more
Speaker 2: readable and are able to look at this kind of information,
Speaker 2: you don't really know exactly how many shots within each
Speaker 2: of the beams are available over your aoy. So this
Speaker 2: is really useful for tracking what's actually going on. And
Speaker 2: then you realize that, oh, you know, I only I
Speaker 2: don't actually have coverage beams for this area. So we'll
Speaker 2: actually visualize this and make it a little easier to read.
Speaker 2: But this just goes through tracking, it defines the size
Speaker 2: and then you get to see, wow, we reduced that
Speaker 2: file ninety eight percent, which is great because we did
Speaker 2: not need all of that other data. So now we
Speaker 2: just do a quick check are they where we want
Speaker 2: them to be? It's just for security, and then we're
Speaker 2: going to go ahead and look at those HDA five files,
Speaker 2: so just something interesting to look at. We're not really
Speaker 2: going to work with them anymore since we're going to
Speaker 2: convert it. But if you want to look at the
Speaker 2: raw files, so let's take a look at a file
Speaker 2: in Pignon and we're looking at the raw files here,
Speaker 2: so you can choose from any of these that you want.
Speaker 2: You can say, okay, cool. So all of these beams
Speaker 2: are potentially available as well as these other groups. And
Speaker 2: these are all of the variables that are there from
Speaker 2: each of these beams in the raw data set. We
Speaker 2: don't really need all of them, but just to see great,
Speaker 2: they're all there. And then if you want to look
Speaker 2: at look at the variables selected, see what happens after
Speaker 2: you subset them. You get to see, oh, okay, great,
Speaker 2: So we actually only have these two beams available after
Speaker 2: we subset, and looks like we got all of the
Speaker 2: variables that we selected. So that's pretty good. And you
Speaker 2: can go ahead and look at the other files and
Speaker 2: see how these change specific to each file. So now
Speaker 2: we're gonna actually look at those variable characteristics across the
Speaker 2: HGA five file. So this is another example of opening up.
Speaker 2: So you hit run on that and you run this,
Speaker 2: and we're just going to look at first the raw
Speaker 2: download just to be able to see what's going on
Speaker 2: with this data set. And so something that we learned
Speaker 2: about in the lecture part of part two was that
Speaker 2: the HGF five files are holding data sets in each group.
Speaker 2: So if you have ancillary or the beam group that
Speaker 2: are of different types. And so when you look at
Speaker 2: this file here, and it's also in the Data dictionary
Speaker 2: that's an online page through the NASA, but you get
Speaker 2: to see the shape of the data set. Is it
Speaker 2: you know, one dimensional, two dimensional? How many points are
Speaker 2: in it? And what type of data is it? So
Speaker 2: is it integer? Is it float? Is it this or that?
Speaker 2: So if we want to look at okay, so let's
Speaker 2: look at this. We have cover here from this file,
Speaker 2: it looks like there's only one shot available and the
Speaker 2: cover is afloat. So this is just really to check
Speaker 2: what's going on if you needed to do some extra
Speaker 2: research with that and understand what's going on with each
Speaker 2: of those files. So these are again all the data sets,
Speaker 2: but if you want to look at something that you
Speaker 2: subset and see what's going on. Okay, So there's nine
Speaker 2: shots that are available here in this here you'll see
Speaker 2: that pa Z the Z profile. So we won't talk
Speaker 2: as much about this, and there's another training with earth
Speaker 2: Rise that talks a little more in detail about this,
Speaker 2: but this is just how it's a two dimensional data
Speaker 2: set of how the PAV values are stored along the
Speaker 2: vertical access so you know, along the heights you get
Speaker 2: a PIAI plant area index value. And so there's thirty
Speaker 2: different value possible values. Not all of them may be
Speaker 2: valid data for each of the shots, so it's a
Speaker 2: different format. It can't be opened the same way. We
Speaker 2: won't go over that in this training, but just to
Speaker 2: recognize that there are data sets of different sizes the
Speaker 2: same thing here, there's just different ways that they're formatted
Speaker 2: within the HD of five files. So if you were
Speaker 2: to customize, you need to pay attention to that and
Speaker 2: then we get a summary of those information. So here
Speaker 2: this is an optional step. If you're working on your
Speaker 2: disc is full and something's going on, you might want
Speaker 2: to go ahead and delete the raw downloads folder to
Speaker 2: get if you're not needing that and you just want
Speaker 2: to work with your final data set. So when you
Speaker 2: click run here and it's on false, it'll tell you, hey,
Speaker 2: set it to true in order to rerun and actually
Speaker 2: delete your files. So that means come over here and
Speaker 2: again there's a question mark to find that, and you'll
Speaker 2: just change that to true, hit run again, and then
Speaker 2: it will delete this entire folder. And if you do
Speaker 2: that again, if you needed that later, you're going to
Speaker 2: have to rerun the download to get those back. So
Speaker 2: now we're going to actually create the geodata frame with
Speaker 2: the subset of HDF five files. So this is what's
Speaker 2: going to help us start thinking about visualizing the data
Speaker 2: and being able to convert it to another data format.
Speaker 2: So we're going to define some functions that help us
Speaker 2: do this, lots of documentation throughout. If you're looking to customize,
Speaker 2: we try to make it easy and understandable. So now
Speaker 2: we're going to go ahead and actually execute converting those
Speaker 2: HTA five files for each AOI, and we're going to
Speaker 2: create a dictionary of geodata frames, so that's one geodata
Speaker 2: frame per AOI that we'll use to plot later. And
Speaker 2: again it's going to be using the data that was
Speaker 2: subset in order to do so. So when we do this,
Speaker 2: it goes through and it tells us what's going on
Speaker 2: with each of these again just to help us track.
Speaker 2: So here we have that it went for each beam.
Speaker 2: It's getting all of the records. So those are the
Speaker 2: individuals the sixteen shots here, thirty six shots, fifty eight
Speaker 2: shots in each of these beams for that file. What
Speaker 2: did it do to each of those data sets? So
Speaker 2: PEGAP datasy we don't really work it with this, but
Speaker 2: this is something that it truncated the information that might
Speaker 2: be something that needs to be investigated and fixed if
Speaker 2: you're using that data. But here it just lets you know, hey,
Speaker 2: I wasn't able to find this in these beams because
Speaker 2: those beams don't exist or how many records were actually processed.
Speaker 2: So for the most part, everything was successfully processed, but
Speaker 2: it might need to you know, be changed if you're
Speaker 2: working with these data sets. And you find that they're
Speaker 2: not correctly downloaded. And so here also the reference length
Speaker 2: that we're using, where did that go? The reference length
Speaker 2: is essentially just looking at lat lowest mode, so that's
Speaker 2: we know that we're looking at the latitude and longitude
Speaker 2: of each shot. We know that that shot exists. So
Speaker 2: if there's thirty six latitude points, then we're just going
Speaker 2: to assume that those are the thirty two shots that
Speaker 2: we want to be able to generate our geodata frame from.
Speaker 2: So that's just a bunch of tracking records for that,
Speaker 2: and then we're able to say, great, we have this available.
Speaker 2: We want to create a variable that allows us to
Speaker 2: access the individual geodata frame for each product or for
Speaker 2: each AOI for that product, so that you can look
Speaker 2: at the data sets. So great, we have the lat
Speaker 2: long Okay, everything looks great, it's in it's it's in order.
Speaker 2: You can see every every data set here some of
Speaker 2: the values and so this is what we're more familiar with.
Speaker 2: So now this is an optional step. So what we
Speaker 2: downloaded here was the so we had the raw file
Speaker 2: that was subset to the variables that we wanted, and
Speaker 2: then we converted that to a geodata frame, but no
Speaker 2: quality processing, no getting rid of, no data values, no
Speaker 2: look into the actual data sets themselves and their quality
Speaker 2: has been done at this point. So if you were
Speaker 2: looking at a study that was you know, comparing different
Speaker 2: quality filters that you wanted to apply, or looking at
Speaker 2: you know, validated the diferens in different validation of the
Speaker 2: results that you get, you might want to save the
Speaker 2: original data set that has had nothing done to it itself.
Speaker 2: So this is an option to do that here before
Speaker 2: you start applying different filters. And this might help you
Speaker 2: compare if you're if you're doing that, or maybe you
Speaker 2: found some literature that you think is really applicable to
Speaker 2: your ecosystem. You don't really care about the raw files
Speaker 2: you've already you know, you know, you're just going to
Speaker 2: apply the final filter data set and that's what you're
Speaker 2: going to work with, and you can skip this step.
Speaker 2: But when you do this, uh, it connects to your
Speaker 2: drive and it creates a folder for shape files or
Speaker 2: csvs where the data is actually saved. So you have
Speaker 2: that's just so it should look like this piinone with
Speaker 2: the product and then you have your shape file files
Speaker 2: all there and again that's the original nothing done to
Speaker 2: the data set, and now we're going to start thinking
Speaker 2: about exploring the quality filtering techniques. So we just click
Speaker 2: run on these cells to establish This just helps us
Speaker 2: visualize and then so we may have defined the beams
Speaker 2: by listing when we wanted to subset, but it's kind
Speaker 2: of hard to remember what each one of those numbers
Speaker 2: is corresponding to. You'd have to you know, memorize that.
Speaker 2: So instead we want to actually label them as power
Speaker 2: or coverage themselves. So we're going to define this function
Speaker 2: that allows us to create a column that tells us
Speaker 2: whether it's coverage or power instead of the individual beam name.
Speaker 2: So that'll help us generate some later figures. So now
Speaker 2: we have our original data set and we're really interested
Speaker 2: in seeing well some basic statistics of what's available when
Speaker 2: this could be make or break for your application of Jedi,
Speaker 2: and so we're going to define some of the functions
Speaker 2: that help us actually get this figure going plot it.
Speaker 2: So again you just click run on all of these.
Speaker 2: There's not much else to do. If you were changing
Speaker 2: some of the aois, you might want to change some
Speaker 2: of the colors, or if you added you might need
Speaker 2: to add some specifications to colors here and we go
Speaker 2: ahead and click run here. And so this is an
Speaker 2: example of what the output would look like. So here
Speaker 2: we have Wow, we have two hundred and fifty five
Speaker 2: total shots that are total observations that were available between
Speaker 2: twenty nineteen and twenty twenty five. Four pinon for Jedi
Speaker 2: level to be. And now we get a little summary
Speaker 2: chart here that tells US across the years, how many
Speaker 2: of those shots are associated with those U what was
Speaker 2: the peak month of how many shots they're worse? You
Speaker 2: see that can vary by what is that thousands across
Speaker 2: across each of these months per year, So it can
Speaker 2: be really important if you're looking at seasonal, seasonally specific applications.
Speaker 2: So I think I have this actually pulled up here.
Speaker 2: So what this does is it puts all the aois
Speaker 2: on one subfigure for each year, so you can do
Speaker 2: a comparison between them. And as you saw, paint Rock
Speaker 2: has very very few. It only has total of sixty
Speaker 2: four shots across all of these years. Now it's a
Speaker 2: small AOI. I don't know why it has that few,
Speaker 2: but this could be your point, you know, if you're looking, Hey,
Speaker 2: I want data from let's say twenty twenty two in
Speaker 2: April or May. For either of these, you can't do
Speaker 2: your study with data from that area because it's just
Speaker 2: not there. So that's what this code helps facilitate, is understanding.
Speaker 2: You know, even if they is potential, it really is variable.
Speaker 2: You just have to open the data in order to
Speaker 2: see how much is available for that time period. Or
Speaker 2: you see, you know, there's only nine ten shots here.
Speaker 2: There's no data from paint Rock in this time period,
Speaker 2: So yeah, it can be incredibly variable. So that's what
Speaker 2: this figure is doing, and then we get a nice
Speaker 2: other kind of descriptive comparison across those years to just
Speaker 2: help us understand. So if you're using it as trained data,
Speaker 2: this could be really really valuable for understanding the representativeness.
Speaker 2: Of course, this is total shots. This isn't even over
Speaker 2: individual land cover types. If you put a land cover mask,
Speaker 2: that could also greatly change the amount of available data
Speaker 2: depending on your application. So now we're going to make
Speaker 2: a bar plot that is similar to this, but now
Speaker 2: comparing beam types. Like I said, there could potentially be
Speaker 2: a very big difference between the power and the coverage beam.
Speaker 2: So when wee we just click run to find this
Speaker 2: function in order to generate our plot, and so we're
Speaker 2: going to get this monthly observations for one AOI. So
Speaker 2: we're just looking at payrock and we have color coded
Speaker 2: for each of the years, separated by power and coverage.
Speaker 2: So we see, okay, well, of all of the shots,
Speaker 2: they are all power, so maybe that's possibly more reliable shots.
Speaker 2: Really depends on the application, but this will help us
Speaker 2: better understand when we actually go and validate. And then
Speaker 2: for this one here, we have some coverage in twenty
Speaker 2: twenty one, but as you can see again, there's a
Speaker 2: very different distribution across the years, and of course we
Speaker 2: get a table that helps us visualize that. And I
Speaker 2: think I have yeah, and you can switch, So this
Speaker 2: widget here allows you to switch to the other. Ay,
Speaker 2: it might take a while depending on how much data
Speaker 2: there is that you're working with. And I kind of
Speaker 2: wanted to show jumping over here. Two. I only selected
Speaker 2: one year's worth of data from twenty twenty two. And
Speaker 2: again this is summarizing all of it, but if you
Speaker 2: just wanted to select, you can do some comparison there.
Speaker 2: So for pinon, we have a bunch of data that's
Speaker 2: distributed very differently across the coverage and power beams. This
Speaker 2: could really help you understand again if you're using it
Speaker 2: as training data, can help you understand the behavior of
Speaker 2: that information and summarize that across as a table. Okay,
Speaker 2: now we're going to look at us out a plot
Speaker 2: and see how many of these values are no data values.
Speaker 2: We want to get rid of those. So here we
Speaker 2: have before we separate. It's really difficult to see what's
Speaker 2: going on and just understand how many of those values
Speaker 2: are removed and what our information looks like across all
Speaker 2: the years, all the data for the AI when that
Speaker 2: no data is removed. And see, there's a lot more
Speaker 2: information that we're seeing here across the track of observations.
Speaker 2: So this is along each of the observations that get dealt.
Speaker 2: So see it's a lot again, there's only sixty four
Speaker 2: in paint Rock, but we understand the behavior a lot better.
Speaker 2: So now with that understanding of a little bit about
Speaker 2: the no data and how much is available, we want
Speaker 2: to go ahead and generate our filter data set. So again,
Speaker 2: if you don't have any data over the time period
Speaker 2: that you're looking at, then for the study area that
Speaker 2: you want, this might be the end of you know,
Speaker 2: you using this script where you'd have to change course
Speaker 2: if you want to use Jedi or if you have
Speaker 2: data and you want to make it higher quality, then
Speaker 2: you know, start applying these filters and see what happens.
Speaker 2: So we're going to remove the no data values. This
Speaker 2: will change when you're using a different product you're going
Speaker 2: to use you know, uh, this is for FH FH
Speaker 2: Foliage High Diversity plannary index and cover. This is what
Speaker 2: we're gonna be looking at in this level to be
Speaker 2: data set, but we also want to look at if
Speaker 2: you want to look at level two a elevation and height,
Speaker 2: you would change these here and get rid of those
Speaker 2: no data and then we have the quality flag and
Speaker 2: the degrade flag which we talked about in part one
Speaker 2: that will apply to remove to keep high quality flags
Speaker 2: and get rid of degraded flags. There are many other
Speaker 2: types of filtering that you can do that we won't
Speaker 2: cover in this training that you would add them to
Speaker 2: this section here if you wanted to apply those and compare.
Speaker 2: And now you see that the data sets reduced. So
Speaker 2: instead of sixty four, now we have forty two in
Speaker 2: paint rock and instead of two hundred fifty thousand, we
Speaker 2: have one hundred and twenty four thousand, So again that'll
Speaker 2: vary by the study area that you have. We can
Speaker 2: map the differences between that. So we have the original
Speaker 2: here and then we have the filtered data set, and
Speaker 2: we can see just how different those are. Again, the
Speaker 2: scale between the no data and the data values change
Speaker 2: from what's available, and we can check that for the
Speaker 2: different data products as well. Pai about a plannary index. Yeah,
Speaker 2: now just to show what happened after we filter, What
Speaker 2: does our distribution of the data across the months look
Speaker 2: like after we get rid of that data. So again
Speaker 2: that can be really variable. You just kind of have
Speaker 2: to see it to see what happens. Could stay largely
Speaker 2: the same paint rock, didn't have too many points that
Speaker 2: were taken out, but you'll see sometimes that could get
Speaker 2: rid of an entire month that you were hoping for
Speaker 2: by applying the filter, which can be really important. Okay,
Speaker 2: and then again an option to save it to shape
Speaker 2: file or CSV. This is your final filtered data set.
Speaker 2: This would be your analysis ready data would be saved
Speaker 2: in the same location with a different suffix specifying that
Speaker 2: it is filtered. So now we're just going to generate
Speaker 2: a few figures. We're going to make a violin plot
Speaker 2: that's gonna again help us summarize but get a little
Speaker 2: bit more information on some statistics of what's going on
Speaker 2: with each of these variables. So we have you know,
Speaker 2: the with the size of the violin plot is telling
Speaker 2: us how many of the data are there in that
Speaker 2: month that are contributing to these statistics across So as
Speaker 2: you can see, there's just different shapes that allow us
Speaker 2: to understand that. And I believe we can see a
Speaker 2: little bit more with pignone here. So you'll get a
Speaker 2: plot for each month to understand a little bit more
Speaker 2: about the distribution per you know, okay, what's going on
Speaker 2: here February not mentioned variability, So yeah, lots to look at,
Speaker 2: lots to interpret over your study area, and then you
Speaker 2: do that for each variable. So for level to be,
Speaker 2: we just looked at the foliage high diversity and you
Speaker 2: can do that for plant area index. So again you'll
Speaker 2: have the same time periods because all of these variables
Speaker 2: are built off of the same original shots, but they'll
Speaker 2: have different values and distributions. Now we'll generate a pairple
Speaker 2: This will include all of the variables that are included
Speaker 2: in that original subset that we copy and pasted everything,
Speaker 2: So we don't go over all of these. You might
Speaker 2: need to take an additional training or go to the
Speaker 2: algorithm theoretical based document for that, but this just helps
Speaker 2: you understand the behavior a little bit more. So we
Speaker 2: know plant area index against cover. We see that there's
Speaker 2: a really strong relationship here, and so this is just
Speaker 2: a nice way to start understanding a little bit more
Speaker 2: about the data sensitivity of the beam. How well is
Speaker 2: the the beam the shot able to penetrate through a canopy,
Speaker 2: and how does that relate to canopy cover. You get
Speaker 2: to see a little bit more about that information here.
Speaker 2: So that plots across all of the available data sets
Speaker 2: that are in your in your file that you subset,
Speaker 2: or you can select a few. And finally we'll go
Speaker 2: over some three dimensional plotting. So here we're going to
Speaker 2: make an interactive plot that allows us to play around
Speaker 2: with what's available. So these are our forty two shots.
Speaker 2: As we're looking at the filtered data set and how
Speaker 2: it looks, it's plotting the visual of the value of
Speaker 2: the variable itself. So right here we're looking at plant
Speaker 2: area index right, and the value of that plant area
Speaker 2: index is what's put on the z axis for each
Speaker 2: of the shots. So you can look at it in
Speaker 2: different ways. You get to see the tracks there and whatnot,
Speaker 2: so there's different ways to view. You can save it
Speaker 2: as a p ANDNG, you can pan, you can do
Speaker 2: different types of rotation across, make a video of yourself
Speaker 2: looking at it. Pretty cool, holo use interactive site and yeah,
Speaker 2: there's a lot more in that other one. We'll see
Speaker 2: if it loads. But then you can also create a
Speaker 2: static three D plots, so something that's a little bit
Speaker 2: easier to save and visualize. So here we have this
Speaker 2: example from Pignon that's you know, thousands of shots that
Speaker 2: we see in order to better understand each of these
Speaker 2: variables cover plant area index, foliage high diversity, get a
Speaker 2: sense for what our landscape looks like with all of
Speaker 2: these shots, and then again you see wow, you know,
Speaker 2: this might not be a lot of data. You'd have
Speaker 2: to think about what kind of value that plays in
Speaker 2: your study area. And again this is across all of
Speaker 2: the years, so it could be greatly reduced if you're
Speaker 2: just looking at a particular time period and not aggregating
Speaker 2: over and this is what it looks like when you
Speaker 2: have a lot of points. Okay, so thank you very much.
Speaker 2: If you have any issues, there is a discussion forum
Speaker 2: on the repo here having to do with these tutorials,
Speaker 2: and I hope you have fun exploring Jedi. So to
Speaker 2: conclude this part too, just wanted to leave with some
Speaker 2: recommendations on additional resources and how to stay updated. So,
Speaker 2: as we've mentioned before, a really great reference for understanding
Speaker 2: the basis and background of all of these data sets
Speaker 2: are there individual algorithm theoretical based documents as well as
Speaker 2: the individual user guides that are hosted by the docs
Speaker 2: and on Earth Data Catalog. The OURNL and lp doc
Speaker 2: sites are always processing updating products, uploading new versions and
Speaker 2: archiving older versions as well. So these are really the
Speaker 2: best sources of information and original and new data sets
Speaker 2: that Jedi and the Jedi Mission team are putting out
Speaker 2: Google Earth Engine are Jedi Jedi dB, which is a
Speaker 2: Python api that recently came out, as well as some
Speaker 2: of the other tools that we mentioned are continuously advancing
Speaker 2: their functionalities, so always revisiting their resources and their their
Speaker 2: main pages you know, will be updated with new functionalities
Speaker 2: to test and if you're interested in learning more application
Speaker 2: specific information on you know, once you have the data
Speaker 2: or you're looking at it, you finally mapped it with
Speaker 2: some of these example scripts or the tools that you've
Speaker 2: been able to access and run through, you know how
Speaker 2: to interpret the data, understand some quality checks, how to
Speaker 2: improve it or optimize it with other data sets. You
Speaker 2: can take the NASA earth Rise Jedi Applications focused training.
Speaker 2: It has another series of hands on tutorials UH in
Speaker 2: collaboration with some of the other collaborators who generated this
Speaker 2: training with our set that are specific for data preparation
Speaker 2: and analysis recommendations. And given that Jedi is a novel
Speaker 2: sensor it was launched in twenty nineteen, the research is
Speaker 2: still very active. So the literature is also a great
Speaker 2: place to go and keep up with in understanding new
Speaker 2: applications or recommendations of using Jedi, and the Jedi Mission
Speaker 2: Page conveniently hosts a Jedi related literature Zoto group that
Speaker 2: gets continuously updated with the latest literature. So thank you
Speaker 2: very much and I hope this training advances your use
Speaker 2: of Jedi.
Speaker 1: Thank you so much, Stephanie. Now I will provide a
Speaker 1: summary of Part two. Let's review the key concepts from
Speaker 1: Part two. First, we cover jedi's mission objectives and applications
Speaker 1: operating from the International Space Station with data from twenty
Speaker 1: nineteen to twenty twenty three and resumed in twenty twenty four.
Speaker 1: JETI quantifies three dimensional ecosystem structure for carbon cycle tracking,
Speaker 1: fire management, weather prediction, water resource monitoring beneath dense forests
Speaker 1: and topography mapping and vegetated areas. We explore jedi's data
Speaker 1: product hierarchy. Level one B products provide geolocated waveforms. Level
Speaker 1: two A extracts elevation and canopy height metrics. Level two
Speaker 1: B calculates canopy cover plant area index, plant area volume
Speaker 1: density and foliage height diversity. Level four A models footprint
Speaker 1: level biomass, while Level four C provides a structural complexity index,
Speaker 1: capturing three dimensional canopy complexity. Understanding file format it's crucial.
Speaker 1: Footprint level data sets at twenty five meter resolution use
Speaker 1: HDF five hierarchical format, requiring specialized tools or coding skills.
Speaker 1: Gridded products like L three and L four B use
Speaker 1: familiar GEOTIP format at one kilometer resolution, with quality filters
Speaker 1: already applied, making them more accessible. Data fusion products overcome
Speaker 1: Jedi's discrete sampling limitations in certain ways. The mission team
Speaker 1: developed fusion products combining Jedi with ISAT II for increased
Speaker 1: sampling density, Tandem x InSAR for wall to wall tropical maps,
Speaker 1: and landsat for continuous canopy height. Products leveraging Jedi's vertical
Speaker 1: precision alongside broader coverage sensors. Field inventory plots from networks
Speaker 1: like US Forest Service Inventory and Analysis established the aleometric
Speaker 1: equations relating ground measurements to Jedi observations. Future missions like
Speaker 1: Hedge will build on this with increased beam density and
Speaker 1: swath mapping for improved change detection. Finally, you learned about
Speaker 1: access tools. Earth Data Search provides downloads with spatial temporal filtering.
Speaker 1: Testfis offers subsetting for level three and level four B products.
Speaker 1: Slide Rule Client enables cloud based processing, Harmony API handles
Speaker 1: HDF five transformation.
Speaker 2: Coding.
Speaker 1: Platforms like our Jedi and Google Earth Engine provide custom
Speaker 1: analysis capabilities. Matching the right tool to your workflow is
Speaker 1: key to working efficiently with Jedi data. In Part three
Speaker 1: of this training, you will be able to utilize Jedi
Speaker 1: standard biomass products at both footprint and one kilometer scals.
Speaker 1: To map forest resources, You'll be able to access the
Speaker 1: open source obi wan API to generate estimates of biomass
Speaker 1: changing areas of interest. You'll also be able to identify
Speaker 1: how obi wan can be used to create baseline scenarios
Speaker 1: for forest carbon accounting projects. To receive a completion certificate
Speaker 1: for this training, you will need to submit the homework assignment,
Speaker 1: which opens on November six and closes on November twentyth.
Speaker 1: This is the contact information for our guest instructor, Stephanie Humanez,
Speaker 1: as well as for myself listed here. We're also including
Speaker 1: links to the r SET website and the r ST
Speaker 1: YouTube channel, where you can find many more trainings like
Speaker 1: this available for free online. Here is a list of
Speaker 1: references and additional resources to look into. Thank you so
Speaker 1: much for your participation in today's training.
Podbean