Add plugin: SDR with USLE C Raster Input

[megannissel]

InVEST Community Plugin Registry Submission Template

• I attest that I have done my best to deliver a high-quality plugin and would recommend it to others. I commit to maintaining the plugin and being responsive to bug reports. If I am no longer able to maintain it, I will make reasonable efforts to find a successor maintainer or withdraw the plugin from the directory.

Repository URL

Please provide the link to the plugin repository here: https://github.com/natcap/invest-sdr-usle-c-raster/

Motivation and Context

Please provide brief answers to the following questions, to help the reviewers quickly and easily confirm that your plugin is germane to the InVEST platform and appropriate for inclusion in the plugin registry.

How does this plugin relate to natural capital, ecosystems services, nature, or nature's benefits to people?

This plugin provides a variant on the core InVEST SDR model. Rather than reading in USLE C values from a biophysical table, a user can provide a raster containing these values.

Why / how do you think this plugin would be valuable to the community?

This plugin was developed based on multiple requests for this feature from members of the InVEST community. From the related InVEST issue discussing the motivations behind this plugin:

I'm helping project partners run SDR, and they want to derive USLE C from NDVI (a very common thing to do), which produces a raster. Yes, we can take the average NDVI-derived value within each LULC area and assign that through the biophysical table, but that dumbs down the finer-scale C raster data unnecessarily.

Not only is deriving USLE C from NDVI a common thing to do in general, it's especially common in data-poor areas (like Alaska, where this current project is), where there are zero studies providing already-calculated C values by land cover type. So users can make use of more localized NDVI data, instead of using extremely generic C values, and/or values derived in Iowa.

Acknowledgements and Disclosures

• I have read the InVEST Code of Conduct and attest that my plugin adheres to it.
• I agree to allow metadata about the submitted plugin to be stored in perpetuity to allow for the persistence of open science and data.
• I have clearly documented data needs and any data licensing restrictions that would be useful for a user to know.

Did you use Generative AI in the development of your plugin?

• Yes, I used generative AI in the development of this plugin.
• No, I did not use generative AI in the development of this plugin.

If generative AI was used, please acknowledge the following:

• The authors of this plugin affirm that all generated material has been reviewed and edited for clarity, correctness, and completeness. The authors acknowledge that they are responsible for the content of their work.

[github-actions]

Thank you for your plugin submission request!

Thank you for submitting a PR to have your plugin included in the InVEST Plugin Registry! Your PR will now undergo a suite of tests including: double-checking your pyproject.toml for all required fields, checking that your plugin imports successfully, and conducting a basic security scan of the plugin repository. For more information about automated tests, please reference the documentation.

If any tests fail, our bot will leave a comment on the PR, tagging you, with a summary of failures. Once tests pass, our team of plugin reviewers will be automatically assigned and one of them will conduct the final evaluation.

[github-actions]

✅ No errors found in the project!
✅ plugins.json and pyproject.toml have matching version
✅ plugin name is unique!
✅ Plugin invest_sdr_usle_c_raster imported successfully; imports are sufficient!
✅ Plugin invest_sdr_usle_c_raster has all required attributes
ℹ️ No medium or high security vulnerabilities found in the plugin repo

Bandit Security Report (medium and high severity)

Run started:2026-06-18 20:45:04.410537+00:00

Test results:
No issues identified.

Code scanned:
Total lines of code: 3323
Total lines skipped (#nosec): 0
Total potential issues skipped due to specifically being disabled (e.g., #nosec BXXX): 0

Run metrics:
Total issues (by severity):
Undefined: 0
Low: 0
Medium: 0
High: 0
Total issues (by confidence):
Undefined: 0
Low: 0
Medium: 0
High: 0
Files skipped (0):

Metadata pulled from pyproject.toml

Project name: invest_sdr_usle_c_raster
Plugin display name: SDR with USLE C Raster Input
Version: pyproject.toml: 1.0.0
License: Apache-2.0
Documentation: https://github.com/natcap/invest-sdr-usle-c-raster/blob/main/README.md
Registry description link: https://raw.githubusercontent.com/natcap/invest-sdr-usle-c-raster/refs/tags/1.0.0/invest_registry_description.md

Project description

InVEST Sediment Delivery Ratio (SDR) variant that expects USLE C values in a raster instead of in the biophysical table.

FYI @megannissel

[phargogh]

/run-validation

[natcap-bot]

✅ No errors found in the project!
✅ plugins.json and pyproject.toml have matching version
✅ plugin name is unique!
✅ Plugin invest_sdr_usle_c_raster imported successfully; imports are sufficient!
✅ Plugin invest_sdr_usle_c_raster has all required attributes
ℹ️ No medium or high security vulnerabilities found in the plugin repo

Bandit Security Report (medium and high severity)

Run started:2026-06-18 21:21:22.139038+00:00

Test results:
No issues identified.

Code scanned:
Total lines of code: 3323
Total lines skipped (#nosec): 0
Total potential issues skipped due to specifically being disabled (e.g., #nosec BXXX): 0

Run metrics:
Total issues (by severity):
Undefined: 0
Low: 0
Medium: 0
High: 0
Total issues (by confidence):
Undefined: 0
Low: 0
Medium: 0
High: 0
Files skipped (0):

Metadata pulled from pyproject.toml

Project name: invest_sdr_usle_c_raster
Plugin display name: SDR with USLE C Raster Input
Version: pyproject.toml: 1.0.0
License: Apache-2.0
Documentation: https://github.com/natcap/invest-sdr-usle-c-raster/blob/main/README.md
Registry description link: https://raw.githubusercontent.com/natcap/invest-sdr-usle-c-raster/refs/tags/1.0.0/invest_registry_description.md

Project description

InVEST Sediment Delivery Ratio (SDR) variant that expects USLE C values in a raster instead of in the biophysical table.

FYI @megannissel