Changelog

Unreleased¶

New H5Table system: generic, lazy HDF5-to-table reader that handles dimension flattening, nodata masking (missing), and transforms automatically.
explore(granule) opens an interactive terminal browser for inspecting HDF5 contents and selecting variables.
table(g; variables=) keyword allows reading custom variable sets instead of only the built-in defaults.
table(g; tracks=) keyword for filtering specific beams/tracks.
Variables now support transforms: ToDateTime, ToBool, InvertBool, SliceRow.
Attributes (track-level metadata like strong_beam, detector_id) are now included as constant columns.
Pre-built alternative schemas: atl08_canopy_variables(), gedi_l2a_canopy_variables().
Documentation rewrite following the Diátaxis framework (tutorials, guides, topics, reference).

table(granule) is now the recommended interface; points() remains available for compatibility (see migration guide).
Fill values are now missing instead of NaN.
Removed deprecated granule_from_file (use granule) and granules_from_folder (use granules).
Removed deprecated find (use search).
Removed deprecated write_granule_urls! (use write_urls).
Removed the deprecated bbox keyword on search; use extent instead.
points/lines no longer accept a NamedTuple for bbox; pass an Extents.Extent (e.g. convert(Extent, (min_x=..., min_y=..., max_x=..., max_y=...))).

Column types resolved at read time via transforms (e.g., delta_time becomes DateTime).
All products now use the shared H5Table infrastructure instead of per-product hardcoded readers.

Fix download! to create directories and normalize paths (#95).
Update Makie compat to 0.24 (#93).
Bump CategoricalArrays compat to 1.
CI dependency bumps (actions/checkout v6, stefanzweifel/git-auto-commit-action v7).

New types Table and PartitionedTable, which support the Tables.jl interface. This prevents allocating code like reduce(vcat, DataFrame.(points(granule))) to get a DataFrame. You can now just call DataFrame(table).
Reduced allocations in retrieving point data.
Introduced before and after keywords in search, to search by date(ranges).
sync utility with aria2c for incremental folder updates.
Makie extension for plotting (plot(granules)).
search(granule, :OtherProduct) for cross-product granule lookup.
id keyword in search for fetching specific granules.

Empty (filtered) granules could result in Vector{BitVector} columns, which have been changed to Vector{Bool}.
GEDI search after migration to LPCLOUD.

points now return either a Table or a PartitionedTable instead of NamedTuple or Vector{NamedTuple}. The old behaviour can be regained by calling parent on these tables.
Removed number_of_returns and return_number from ICESat-2 ATL08 canopy output.

Most of the search functionality has been moved out to the more generic EarthData.jl.
Updated ICESat-2 from version 5 to version 6.

GeoInterface, Extents support
Bounding box using Extent subsetting on all points functions
find renamed to search
search now takes the product as a Symbol and accepts a s3::Bool parameter.
Stricter checking of arguments in search
MultiPolygon extents of granules are now returned in the polygons field in granules from search.
Removed bbox field on granules.
download(granule) now works on AWS S3 urls
donwload(granule) now creates temporary files and renames after successful download
ICESat-2 ATL08 v5 points function now supports 20 m resolution by passing highres::Bool parameter.

Fixed ICESat-2 download (please remove n5eil01u.ecs.nsidc.org from your .netrc file)
Linked to Zenodo for DOI citations

Warning

This is a breaking release

Many of the column names have changed to be more descriptive.
Documentation and docstring improvements.
Tables support, you can now do DataFrame(granule), without having to call points(granule).
Memory use improvements, by using SentinelArray of FillArray under the hood.
Dropped S3, GeoArrays and LAS/LAZ support.
Added GeoInterface support for lines/points and dropped GeoDataFrames
Expanded test coverage.