Fix DataArray.integrate API inconsistency - change 'dim' parameter to 'coord'

[Copilot]

This PR fixes an API inconsistency in the DataArray.integrate method where it used a dim parameter while all other related methods consistently use coord.

Problem

The API was inconsistent across differentiation and integration methods:

# These all use 'coord' parameter consistently
ds.differentiate(coord='x')
da.differentiate(coord='x') 
ds.integrate(coord='x')

# But this one used 'dim' - inconsistent!
da.integrate(dim='x')  # Should be coord='x'

As noted in the issue, this inconsistency is confusing because "it doesn't make sense to integrate or differentiate over a dim because a dim by definition has no information about the distance between grid points." The operation should be performed over coordinates, not dimensions.

Solution

Changed DataArray.integrate to use coord parameter for consistency:

• Method signature: integrate(dim=...) → integrate(coord=...)
• Docstring: Updated parameter description and examples
• Implementation: Updated internal call to pass coord parameter correctly
• Tests: Updated unit test to use new parameter name

Backward Compatibility

Existing code using positional arguments continues to work unchanged:

da.integrate("x")  # Still works exactly the same

Only keyword argument usage changes:

da.integrate(dim="x")   # OLD - would now raise TypeError
da.integrate(coord="x") # NEW - correct usage

Result

All differentiation and integration methods now have consistent APIs:

ds.differentiate(coord='x')  # ✓
da.differentiate(coord='x')  # ✓
ds.integrate(coord='x')      # ✓
da.integrate(coord='x')      # ✓ Fixed!

This makes the API more intuitive and aligns with the principle that integration and differentiation operate on coordinates, not dimensions.

Fixes #1.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud