Skip to content

Rename module xclim.indices to xclim.compute#2330

Draft
aulemahal wants to merge 7 commits into
dev-v099from
refactor-v1
Draft

Rename module xclim.indices to xclim.compute#2330
aulemahal wants to merge 7 commits into
dev-v099from
refactor-v1

Conversation

@aulemahal

@aulemahal aulemahal commented Mar 6, 2026

Copy link
Copy Markdown
Collaborator

Pull Request Checklist:

  • This PR addresses an already opened issue (for bug fixes / features)
  • Tests for the changes have been added (for bug fixes / features)
    • (If applicable) Documentation has been added / updated (for bug fixes / features)
  • CHANGELOG.rst has been updated (with summary of main changes)
    • Link to issue (:issue:number) and pull request (:pull:number) has been added

What kind of change does this PR introduce?

Functions previously called "indices" are now called "compute functions", with the additional qualifier "index-like" when needed. I tried to remove the word "indices" as much as possible, but preserved it when it actually meant the plural of "index" (like for SPI-like things) or when the usage comes from an external source (ex: "fire weather indices", "icclim indices").

Does this PR introduce a breaking change?

You bet it does!

Other information:

This must come with a major revision of the documentation, I might delete duplicate/useless notebooks. But I'll try to limit the changes to the subject here : indices vs indicators. Other documentation reorganisation/revision for v1 is to be done elsewhere.

@aulemahal aulemahal added the xclim-v1 First major release of xclim label Mar 6, 2026
@review-notebook-app

Copy link
Copy Markdown

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@github-actions github-actions Bot added docs Improvements to documenation indicators Climate indices and indicators labels Mar 6, 2026
@aulemahal aulemahal changed the title indices to compute - rm xsdba - expose ensemble calendar Rename module xclim.indices to xclim.compute Mar 6, 2026
@github-actions github-actions Bot added the CI Automation and Contiunous Integration label Apr 9, 2026
Signed-off-by: Trevor James Smith <10819524+Zeitsperre@users.noreply.github.com>
@aulemahal

Copy link
Copy Markdown
Collaborator Author

We can do the same work division as in the other PR ?

The goal here is to go through the documentation and put more emphasis on the indicators, less on the compute function, or at least clarify the difference.

  • About
  • Why xclim ?
  • Basic Usage
  • Examples
    • Workflow
    • Ensembles, Ensemble-Reduction
    • Frequency analysis
    • Customizing (@aulemahal)
    • Extending xclim (@aulemahal )
    • Spatial analogues
    • Uncertainty
  • Unit handling

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CI Automation and Contiunous Integration docs Improvements to documenation indicators Climate indices and indicators xclim-v1 First major release of xclim

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants