diff --git a/docs/source/_images/feature/bands/optical_bands.png b/docs/source/_images/feature/bands/optical_bands.png new file mode 100644 index 0000000000..9916aaf9f2 Binary files /dev/null and b/docs/source/_images/feature/bands/optical_bands.png differ diff --git a/docs/source/_images/feature/bands/radar_export.png b/docs/source/_images/feature/bands/radar_export.png new file mode 100644 index 0000000000..44fa26e7da Binary files /dev/null and b/docs/source/_images/feature/bands/radar_export.png differ diff --git a/docs/source/cookbook/optical_mosaic.rst b/docs/source/cookbook/optical_mosaic.rst index e2c2718e3b..57bd248f55 100644 --- a/docs/source/cookbook/optical_mosaic.rst +++ b/docs/source/cookbook/optical_mosaic.rst @@ -399,7 +399,7 @@ Selecting the :icon:`fa-solid fa-cloud-arrow-down` tab will open the **Retrieve* Bands """"" -You need to select the band(s) to export with the mosaic. There is no maximum number of bands, but exporting useless bands will only increase the size and time of the output. To discover the full list of available bands with SEPAL, see :doc:`../feature/bands`. +You need to select the band(s) to export with the mosaic. There is no maximum number of bands, but exporting useless bands will only increase the size and time of the output. To discover the full list of available bands with SEPAL, see :doc:`../feature/optical_bands`. .. tip:: diff --git a/docs/source/cookbook/time_series.rst b/docs/source/cookbook/time_series.rst index 54e69e3082..eb061cf2a8 100644 --- a/docs/source/cookbook/time_series.rst +++ b/docs/source/cookbook/time_series.rst @@ -141,7 +141,7 @@ Available bands The wavelength of each band is dependent on the satellite used. -The time series will use a single observation for each pixel. This observation can be one of the available bands in SEPAL. To discover the full list of available bands, see :doc:`../feature/bands`. +The time series will use a single observation for each pixel. This observation can be one of the available bands in SEPAL. To discover the full list of available bands, see :doc:`../feature/optical_bands` and `../feature/radar_bands`. Analysis -------- diff --git a/docs/source/feature/bands.rst b/docs/source/feature/bands.rst deleted file mode 100644 index c618e6e78b..0000000000 --- a/docs/source/feature/bands.rst +++ /dev/null @@ -1,4 +0,0 @@ -Available bands -=============== - -.. include:: ../_templates/no_feature.rst diff --git a/docs/source/feature/index.rst b/docs/source/feature/index.rst index 15ca31d9b1..2732649bc5 100644 --- a/docs/source/feature/index.rst +++ b/docs/source/feature/index.rst @@ -8,6 +8,9 @@ SEPAL features include: .. toctree:: :maxdepth: 1 - :glob: - * + Organize recipes + AOI selection + Optical bands + Radar bands + Visualization diff --git a/docs/source/feature/optical_bands.rst b/docs/source/feature/optical_bands.rst new file mode 100644 index 0000000000..6041848331 --- /dev/null +++ b/docs/source/feature/optical_bands.rst @@ -0,0 +1,271 @@ +Optical Satellite bands, transformations, and indices +===================================================== + +When exporting an optical satellite image in SEPAL, you can choose from a variety of bands, transformations, and indices to enhance your analysis and visualization. Understanding the characteristics and applications of different bands can help you optimize your image processing workflow and extract valuable insights from satellite data. + +.. thumbnail:: ../_images/feature/bands/optical_bands.png + :title: SEPAL Optical Bands to export + :width: 50% + :align: center + + +Bands +----- + +Satellite imagery is composed of multiple bands, each capturing light in specific wavelengths. Depending on the satellite sensor and mission, SEPAL offers a range of bands that can be used for export and analysis. + ++------------+------------+-----------+-----------+-----------+------------+ +| Band | Sentinel 2 | Landsat 9 | Landsat 8 | Landsat 7 | Landsat TM | ++============+============+===========+===========+===========+============+ +| pan | ❌ | ✅ | ✅ | ✅ | ❌ | ++------------+------------+-----------+-----------+-----------+------------+ +| aerosol | ✅ | ✅ | ✅ | ❌ | ❌ | ++------------+------------+-----------+-----------+-----------+------------+ +| blue | ✅ | ✅ | ✅ | ✅ | ✅ | ++------------+------------+-----------+-----------+-----------+------------+ +| green | ✅ | ✅ | ✅ | ✅ | ✅ | ++------------+------------+-----------+-----------+-----------+------------+ +| red | ✅ | ✅ | ✅ | ✅ | ✅ | ++------------+------------+-----------+-----------+-----------+------------+ +| nir | ✅ | ✅ | ✅ | ✅ | ✅ | ++------------+------------+-----------+-----------+-----------+------------+ +| redEdge1 | ✅ | ❌ | ❌ | ❌ | ❌ | ++------------+------------+-----------+-----------+-----------+------------+ +| redEdge2 | ✅ | ❌ | ❌ | ❌ | ❌ | ++------------+------------+-----------+-----------+-----------+------------+ +| redEdge3 | ✅ | ❌ | ❌ | ❌ | ❌ | ++------------+------------+-----------+-----------+-----------+------------+ +| redEdge4 | ✅ | ❌ | ❌ | ❌ | ❌ | ++------------+------------+-----------+-----------+-----------+------------+ +| swir1 | ✅ | ✅ | ✅ | ✅ | ✅ | ++------------+------------+-----------+-----------+-----------+------------+ +| swir2 | ✅ | ✅ | ✅ | ✅ | ✅ | ++------------+------------+-----------+-----------+-----------+------------+ +| cirrus | ✅ | ✅ | ✅ | ❌ | ❌ | ++------------+------------+-----------+-----------+-----------+------------+ +| thermal | ❌ | ✅ | ✅ | ✅ | ✅ | ++------------+------------+-----------+-----------+-----------+------------+ +| thermal2 | ❌ | ✅ | ✅ | ✅ | ❌ | ++------------+------------+-----------+-----------+-----------+------------+ +| waterVapor | ✅ | ❌ | ❌ | ❌ | ❌ | ++------------+------------+-----------+-----------+-----------+------------+ +| brightness | ✅ | ✅ | ✅ | ✅ | ✅ | ++------------+------------+-----------+-----------+-----------+------------+ +| greenness | ✅ | ✅ | ✅ | ✅ | ✅ | ++------------+------------+-----------+-----------+-----------+------------+ +| wetness | ✅ | ✅ | ✅ | ✅ | ✅ | ++------------+------------+-----------+-----------+-----------+------------+ +| fourth | ✅ | ✅ | ✅ | ✅ | ✅ | ++------------+------------+-----------+-----------+-----------+------------+ +| fifth | ✅ | ✅ | ✅ | ✅ | ✅ | ++------------+------------+-----------+-----------+-----------+------------+ +| sixth | ✅ | ✅ | ✅ | ✅ | ✅ | ++------------+------------+-----------+-----------+-----------+------------+ + +Description +----------- + +**Pan (Panchromatic)** + - **Description**: Captures data in a single broad wavelength band, offering higher spatial resolution. + - **Wavelengths**: + - 0.500-0.680 µm, only for Landsat. + - **Usage**: High-resolution imaging for mapping and urban planning. + +**Aerosol** + - **Description**: Used for detecting aerosols (tiny particles) in the atmosphere, which can be crucial for air quality monitoring and climate studies. + - **Wavelengths**: + - 0.433-0.453 µm for Landsat 8 and 9. + - 0.443-0.463 µm for Sentinel-2. + - **Usage**: Air pollution assessment, wildfire smoke tracking. + +**Blue** + - **Description**: Captures light in the blue wavelength. + - **Wavelengths**: + - 0.450-0.510 µm for Landsat 8 and 9. + - 0.490-0.555 µm for Sentinel-2. + - **Usage**: Coastal water mapping, vegetation health monitoring, and identification of shallow water bodies. + +**Green** + - **Description**: Captures light in the green wavelength. + - **Wavelengths**: + - 0.530-0.590 µm for Landsat 8 and 9. + - 0.560-0.595 µm for Sentinel-2. + - **Usage**: Mapping vegetation, water bodies, and urban areas. + +**Red** + - **Description**: Captures light in the red wavelength. + - **Wavelengths**: + - 0.640-0.670 µm for Landsat 8 and 9. + - 0.665-0.695 µm for Sentinel-2. + - **Usage**: Vegetation analysis, especially in calculating vegetation indices like NDVI. + +**NIR (Near-Infrared)** + - **Description**: Captures light in the near-infrared spectrum. + - **Wavelengths**: + - 0.850-0.880 µm for Landsat 8 and 9. + - 0.780-0.900 µm for Sentinel-2. + - **Usage**: Differentiating between vegetation and water, and monitoring vegetation health. + +**Red Edge (4)** + - **Description**: 4 narrow Bands in the VNIR vegetation red edge spectral domain: Red edge 1, Red edge 2, Red edge 3, Red edge 4, is a region of the electromagnetic spectrum where the spectral reflectance of green vegetation changes rapidly + - **Wavelengths**: + - ~704nm,~740nm, ~783nm and ~865nm, only for Sentinel-2. + - **Usage**: Detailed vegetation health monitoring, particularly for precision agriculture. + +**SWIR 1 (Shortwave Infrared 1)** + - **Description**: Captures light in the shortwave infrared spectrum. + - **Wavelengths**: + - 1.570-1.650 µm for Landsat 8 and 9. + - 1.560-1.660 µm for Sentinel-2. + - **Usage**: Detecting moisture content in soil and vegetation, mapping burned areas. + +**SWIR 2 (Shortwave Infrared 2)** + - **Description**: Captures light in the shortwave infrared spectrum. + - **Wavelengths**: + - 2.110-2.290 µm for Landsat 8 and 9. + - 2.100-2.280 µm for Sentinel-2. + - **Usage**: Distinguishing snow from clouds, mapping geological features, and burn scars. + +**Cirrus** + - **Description**: A band designed to detect high-altitude cirrus clouds. + - **Wavelengths**: + - 1.360-1.380 µm for Landsat 8 and 9. + - 1.360-1.390 µm for Sentinel-2. + - **Usage**: Cloud screening in high-altitude regions to improve atmospheric correction. + +**Thermal 1** + - **Description**: Measures thermal radiation emitted by the Earth's surface. + - **Wavelengths**: + - 10.60-11.19 µm for Landsat 8 and 9. + - **Usage**: Monitoring land surface temperature, detecting fires, and assessing volcanic activity. + +**Thermal 2** + - **Description**: Measures thermal radiation emitted by the Earth's surface. + - **Wavelengths**: + - 11.50-12.51 µm for Landsat 8 and 9. + - **Usage**: Monitoring land surface temperature, detecting fires, and assessing volcanic activity. + +**Water Vapor** + - **Description**: Sensitive to atmospheric water vapor absorption, commonly used for weather and climate studies. + - **Usage**: Studying cloud formation, precipitation, and humidity levels. + + +Tasseled Cap Transformation +--------------------------- + +The Tasseled Cap Transformation is a method to transform satellite imagery into three brightness components (Brightness, Greenness, and Wetness) and three color components (Red, Green, and Blue). This transformation is particularly useful for analyzing land cover changes, vegetation health, and urban development over time. + +**Brightness** + - **Description**: Measures the brightness band measures the overall brightness of the image, specifically the soil. + - **Usage**: this band is often used to identify bare or partially covered soil, man-made features, and natural features like asphalt, concrete, gravel, and rock outcrops. + +**Greenness** + - **Description**: Measures the density and health of vegetation by capitalizing on the chlorophyll absorption in the red band and the high reflectance in the near-infrared band. It enhances the contrast between vegetated areas and non-vegetated areas. + - **Usage**: Widely used in assessing plant health, monitoring crop conditions, tracking forest cover changes, and managing natural resources. + +**Wetness** + - **Description**: Captures moisture content in both soil and vegetation. This band is sensitive to the moisture continuum from dry to wet surfaces, helping to differentiate moist soils and saturated vegetation from dry areas. + - **Usage**: Important for identifying wetlands, managing irrigation in agriculture, detecting flood-prone areas, and conducting soil moisture studies. + +**Fourth Component** + - **Description**: Often calibrated to highlight additional properties of vegetation or soil, such as senescence or specific soil types. The exact nature of this band can vary depending on the coefficients and sensor used. + - **Usage**: Can be used to differentiate between types of vegetation or stages of crop maturity, and to detect stressed vegetation in forestry and agriculture. + +**Fifth Component** + - **Description**: Typically emphasizes land disturbance or variability in land cover types, providing a finer distinction between different types of ground cover and land use. + - **Usage**: Useful in monitoring land cover changes over time, detecting disturbances like deforestation or urban expansion, and enhancing land cover classification schemes. + +**Sixth Component** + - **Description**: This band often captures more subtle or residual information that the other bands do not emphasize. It can be less directly interpretable and might be seen as highlighting noise or anomalies in the data. + - **Usage**: Potentially useful for detecting subtle ecological changes, analyzing noise in the data for improved image processing, and refining classifications by providing additional context. + + +Vegetation Indices +------------------ + +Vegetation indices are mathematical transformations of satellite data that highlight specific vegetation properties, such as chlorophyll content, leaf area, or vegetation health. These indices are widely used in agriculture, forestry, and environmental monitoring to assess plant growth, detect stress, and monitor land cover changes. + +**NDVI (Normalized Difference Vegetation Index)** + - **Description**: Measures the density and health of vegetation by calculating the difference between the near-infrared (NIR) and red light reflected by vegetation. Healthy vegetation absorbs most of the visible light and reflects a large portion of the NIR. + - **Usage**: Used to assess vegetation health, monitor drought, and manage agricultural operations. + - **Formula**: (NIR - Red) / (NIR + Red) + +**NDMI (Normalized Difference Moisture Index)** + - **Description**: Highlights moisture content in vegetation by utilizing the NIR and short-wave infrared (SWIR1) bands. It is sensitive to moisture content in vegetation. + - **Usage**: Useful in monitoring vegetation hydration and managing irrigation in agricultural contexts. + - **Formula**: (NIR - SWIR1) / (NIR + SWIR1) + +**NDWI (Normalized Difference Water Index)** + - **Description**: Designed to identify and monitor changes in water content in vegetation, leveraging the green and NIR bands to maximize the reflection differences. + - **Usage**: Employed in monitoring water stress in crops, detecting water bodies, and managing wetland areas. + - **Formula**: (Green - NIR) / (Green + NIR) + +**MNDWI (Modified Normalized Difference Water Index)** + - **Description**: Enhances the detection of surface water by using the green and SWIR1 bands, reducing the influence of built-up land that can be confused with water in traditional NDWI. + - **Usage**: Used to map and monitor surface water bodies, crucial for flood mapping and water resource management. + - **Formula**: (Green - SWIR1) / (Green + SWIR1) + +**NDFI (Normalized Difference Fraction Index)** + - **Description**: Typically used to distinguish between different types of vegetation and non-vegetation elements, providing a measure of vegetation cover fraction. + - **Usage**: Utilized in forest management and land cover classification tasks. + - **Formula**: Index-specific, varies based on application. + +**EVI (Enhanced Vegetation Index)** + - **Description**: Improves the NDVI by optimizing the vegetation signal with improved sensitivity in high biomass regions and reducing background and atmospheric noise. + - **Usage**: Frequently used in areas where vegetation monitoring requires greater sensitivity to biomass. + - **Formula**: 2.5 * (NIR - Red) / (NIR + 6 * Red - 7.5 * Blue + 1) + +**EVI2 (Enhanced Vegetation Index 2)** + - **Description**: A refinement of EVI that uses only red and NIR bands, designed for areas where blue band data may not be reliable. + - **Usage**: Ideal for vegetation monitoring through dense atmosphere or where the blue band is unavailable. + - **Formula**: 2.5 * (NIR - Red) / (NIR + 2.4 * Red + 1) + +**SAVI (Soil-Adjusted Vegetation Index)** + - **Description**: Adjusts the NDVI for the influence of soil brightness, particularly useful in areas with sparse vegetation where soil is visible. + - **Usage**: Applied in semi-arid regions to improve the accuracy of vegetation assessments. + - **Formula**: (1.5 * (NIR - Red) / (NIR + Red + 0.5)) + +**NBR (Normalized Burn Ratio)** + - **Description**: Utilizes NIR and SWIR2 bands to assess the severity of burn damage and the delineation of burned areas. + - **Usage**: Key for assessing post-fire recovery in forested areas and mapping burn severity. + - **Formula**: (NIR - SWIR2) / (NIR + SWIR2) + +**MVI (Mangrove Vegetation Index)** + - **Description**: Specifically designed to enhance the detection and monitoring of mangrove forests by using NIR and green bands. + - **Usage**: Used in coastal management and conservation of mangrove ecosystems. + - **Formula**: 0.1 * (NIR - Green) / abs(SWIR1 - Green) + +**UI (Urban Index)** + - **Description**: Highlights urban areas by exploiting the differences in reflection between SWIR2 and NIR bands. + - **Usage**: Useful for urban mapping and monitoring changes in urban land use. + - **Formula**: (SWIR2 - NIR) / (SWIR2 + NIR) + +**NDBI (Normalized Difference Built-up Index)** + - **Description**: Differentiates urban and built-up areas from natural land cover by using NIR and SWIR1 bands. + - **Usage**: Employed in urban planning and studying urban heat islands. + - **Formula**: (SWIR1 - NIR) / (SWIR1 + NIR) + +**IBI (Index-based Built-up Index)** + - **Description**: Combines NDBI with SAVI and MNDWI to provide a more comprehensive measure of built-up areas. + - **Usage**: Useful in detailed urban analysis and land use classification. + - **Formula**: (NDBI - (SAVI + MNDWI) / 2) / (NDBI + (SAVI + MNDWI) / 2) + +**NBI (New Built-up Index)** + - **Description**: Employs red, NIR, and SWIR1 bands to enhance the detection of built-up areas. + - **Usage**: Applied in urban growth monitoring and land use planning. + - **Formula**: Red * SWIR1 / NIR + +**EBBI (Enhanced Built-Up and Bareness Index)** + - **Description**: Focuses on urban areas and bare land by incorporating thermal and SWIR1 bands to detect built-up regions. + - **Usage**: Crucial for urban mapping and identifying heat-stressed areas in cities. + - **Formula**: (SWIR1 - NIR) / (10 * sqrt(SWIR1 + Thermal)) + +**BUI (Built-Up Index)** + - **Description**: Combines multiple SWIR bands to enhance the detection and differentiation of built-up areas. + - **Usage**: Employed in urban and regional planning to delineate built-up from natural areas. + - **Formula**: (Red - SWIR1) / (Red + SWIR1) + (SWIR2 - SWIR1) / (SWIR2 + SWIR1) + +**KNDVI (Kernel Normalized Difference Vegetation Index)** + - **Description**: Applies a kernel function to traditional NDVI to improve sensitivity and accuracy in vegetation monitoring. + - **Usage**: Used in precision agriculture and detailed vegetation studies where standard NDVI is not sufficient. + - **Formula**: Kernel-function applied to NDVI, specific implementation details vary. diff --git a/docs/source/feature/project.rst b/docs/source/feature/project.rst index c721344a64..e93a776f5c 100644 --- a/docs/source/feature/project.rst +++ b/docs/source/feature/project.rst @@ -1,5 +1,5 @@ -Recipe projects -=============== +Organize Recipes by projects +============================ When interacting with SEPAL processes, a user creates **Recipes**, which can work together and be interconnected inside a single project (e.g. :code:`Mosaics` used in a :code:`Classification`). diff --git a/docs/source/feature/radar_bands.rst b/docs/source/feature/radar_bands.rst new file mode 100644 index 0000000000..6d44f113ba --- /dev/null +++ b/docs/source/feature/radar_bands.rst @@ -0,0 +1,33 @@ +Sentinel-1 Radar Bands +====================== + +When exporting a radar mosaic from the SEPAL platform, the following radar band metrics are available for analysis: + +.. thumbnail:: ../_images/feature/bands/radar_export.png + :title: SEPAL Optical Bands to export + :align: center + :width: 50% + + +Basic Radar Metrics (VV and VH Polarizations) +--------------------------------------------- + +- **Metrics Included**: + - *VV_min, VV_max, VV_mean, VV_std, VV_med*: Statistics of the VV polarization signal, covering minimum, maximum, mean, standard deviation, and median. + - *VH_min, VH_max, VH_mean, VH_std, VH_med*: Similar statistics for the VH polarization. + - *ratio_VV_med_VH_med*: The ratio of the median values of VV to VH polarizations, indicating surface roughness and moisture. + - *VV_cv, VH_cv*: Coefficient of variation for VV and VH, showing the variability relative to the mean. + - *NDCV (Normalized Difference Coefficient of Variation)*: A normalized measure that highlights differences in texture or moisture content between VV and VH returns. + - *orbit*: The orbit direction (ascending or descending), which can affect the radar's observation angle and thus the backscatter properties. + +- **Description**: These metrics are essential for analyzing surface features, moisture content, vegetation, and other land cover characteristics using radar backscatter properties. +- **Usage**: Widely used in agricultural monitoring, flood mapping, forest monitoring, and urban expansion studies. + +Harmonic Analysis Metrics (Conditional on Data Availability) +------------------------------------------------------------ + +- **Metrics Included** (Only if harmonic dependents are available): + - *VV_phase, VV_amp, VV_res*: Phase, amplitude, and residuals of the VV signal following harmonic analysis. + - *VH_phase, VH_amp, VH_res*: Similar metrics for the VH signal. +- **Description**: Harmonic analysis metrics help in understanding seasonal variations and temporal patterns in the radar signal, useful for long-term monitoring. +- **Usage**: Ideal for studying seasonal changes in vegetation, detecting changes in water bodies over time, and monitoring environmental changes. diff --git a/docs/source/feature/visualization.rst b/docs/source/feature/visualization.rst new file mode 100644 index 0000000000..ac6f5bd397 --- /dev/null +++ b/docs/source/feature/visualization.rst @@ -0,0 +1,34 @@ +Visualization in SEPAL +====================== + +**Natural color: red, green, blue** + - **Description**: Represents the true color of the terrain as human eyes would see it, using the red, green, and blue bands. + - **Usage**: Used for general mapping and visual inspections where true color representation is necessary. + +**False color: nir, red, green** + - **Description**: Uses near-infrared, red, and green bands. Vegetation appears red due to the high reflection of NIR by healthy vegetation, helpful for distinguishing vegetative areas. + - **Usage**: Commonly used in vegetation studies to easily distinguish live green vegetation, which reflects NIR strongly. + +**False color: nir, swir1, red** + - **Description**: Combines near-infrared, short-wave infrared, and red bands. This combination is effective in highlighting vegetation and differentiating moisture levels and geological features. + - **Usage**: Useful in geological mapping, vegetation health assessment, and moisture content analysis. + +**False color: swir2, nir, red** + - **Description**: Utilizes short-wave infrared, near-infrared, and red bands. It enhances the differentiation between mineral types and can indicate burn severity in post-fire assessments. + - **Usage**: Often used in mineralogical mapping, soil and rock differentiation, and detecting burned areas. + +**False color: swir2, swir1, red** + - **Description**: Involves short-wave infrared bands and red band. This setup enhances geological features and is sensitive to water content and urban areas. + - **Usage**: Ideal for enhanced geological mapping, urban sprawl studies, and discriminating between different water bodies. + +**False color: swir2, nir, green** + - **Description**: Features short-wave infrared, near-infrared, and green bands. This visualization aids in the analysis of vegetation health and soil/water interactions. + - **Usage**: Useful for detailed vegetation health monitoring and differentiating water stress in plants. + +**Tasseled cap: brightness, greenness, wetness** + - **Description**: Applies the Tasseled Cap transformation to highlight physical properties of the land surface such as brightness (reflectivity), greenness (vegetation), and wetness (moisture content). + - **Usage**: Extensively used in environmental monitoring, land cover classification, and assessing vegetation and water content dynamics. + +**Tasseled cap: fifth, sixth, fourth** + - **Description**: Another Tasseled Cap visualization focusing on the additional components that might reflect other surface properties not captured by the primary three bands. + - **Usage**: Useful for specialized studies in vegetation dynamics, soil properties, and other environmental monitoring where standard Tasseled Cap indices might need supplementation. diff --git a/docs/source/feature/vizualisation.rst b/docs/source/feature/vizualisation.rst deleted file mode 100644 index bed199f11d..0000000000 --- a/docs/source/feature/vizualisation.rst +++ /dev/null @@ -1,4 +0,0 @@ -Visualization -============= - -.. include:: ../_templates/no_feature.rst diff --git a/pyproject.toml b/pyproject.toml index af9e7cd29a..52c175cde8 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -12,4 +12,4 @@ ignore-path = ["docs/source/modules/*"] [tool.codespell] skip = 'docs/source/_data/modules/*.json,*.po,docs/source/modules/dwn/*,docs/build/*,docs/source/_bib/workflows/drivers.bib,docs/source/_data/*' -ignore-words-list='alos,cywgin,toi,aoi' \ No newline at end of file +ignore-words-list='alos,cywgin,toi,aoi,bui,BUI' \ No newline at end of file