Skip to content

docs(foursail): add hotspot and polar BRDF tutorials#62

Merged
cfranken merged 1 commit into
mainfrom
docs/foursail-examples
May 14, 2026
Merged

docs(foursail): add hotspot and polar BRDF tutorials#62
cfranken merged 1 commit into
mainfrom
docs/foursail-examples

Conversation

@cfranken
Copy link
Copy Markdown
Member

foursail_hotspot.jl walks through the principal-plane BRF at 685 and 800 nm with PROSPECT-PRO leaves, contrasting rsot with and without the Kuusk hotspot and overlaying the embedded rsost branch.

foursail_brdf.jl uses FourSAILGeometrySet to evaluate the full (VZA, VAZ) half-sphere in one batched call and visualizes the angular NDVI effect against nadir, including the hotspot in 4SAIL's raa = 0 convention.

foursail_hotspot.jl walks through the principal-plane BRF at 685 and
800 nm with PROSPECT-PRO leaves, contrasting rsot with and without the
Kuusk hotspot and overlaying the embedded rsost branch.

foursail_brdf.jl uses FourSAILGeometrySet to evaluate the full
(VZA, VAZ) half-sphere in one batched call and visualizes the angular
NDVI effect against nadir, including the hotspot in 4SAIL's raa = 0
convention.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 14, 2026 22:28
@cfranken cfranken self-assigned this May 14, 2026
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds two new 4SAIL-focused documentation tutorials that demonstrate (1) principal-plane hotspot behavior and (2) full polar BRDF evaluation/NDVI angular sensitivity, and wires them into the docs build so they appear under Tutorials.

Changes:

  • Add a principal-plane hotspot diagnostic tutorial using FourSAILGeometrySet and PROSPECT-PRO leaf optics.
  • Add a polar BRDF / angular-NDVI tutorial evaluating a full (VZA, VAZ) grid in a single batched 4SAIL call.
  • Update docs/make.jl to generate and include the two new tutorial pages.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
docs/src/pages/tutorials/foursail_hotspot.jl New Literate tutorial demonstrating hotspot impact in the solar principal plane and decomposed branches (rsot, rsost).
docs/src/pages/tutorials/foursail_brdf.jl New Literate tutorial computing half-sphere BRDF and visualizing NDVI angular variation in polar coordinates.
docs/make.jl Adds the new tutorials to the Literate conversion list and Tutorials navigation.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +60 to +63
opti = CanopyOptics.createLeafOpticalStruct(400.0:1.0:2500.0)
T_grid, R_grid = CanopyOptics.prospect(leaf, opti)
λ_grid = [Float64(v.val) for v in opti.λ]
grid_idx = [argmin(abs.(λ_grid .- λ)) for λ in lambda_nm]
Comment thread docs/src/pages/tutorials/foursail_brdf.jl
@cfranken cfranken merged commit 09302c1 into main May 14, 2026
5 checks passed
@cfranken cfranken deleted the docs/foursail-examples branch May 14, 2026 22:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants