Supply source disaggregation, irrigation conveyance, temporal rebase, dynamic population, and feature enhancements

[hassaniazi]

This pull request introduces several enhancements and fixes across the codebase, focusing on improving configuration flexibility, dependency management, spatial data handling, and documentation accuracy. Major changes include adding new configuration options for source disaggregation and irrigation conveyance efficiency, updating the installation and dependency requirements, extending spatial cropping capabilities, and improving CI workflows.

Configuration and Model Enhancements:

• Added new configuration options source_disaggregation (to optionally output source shares for withdrawals) and irrigation_conveyance_efficiency (to adjust irrigation withdrawals) in both the YAML config and the Tethys model class. Updated the constructor and documentation to reflect these options. [1] [2] [3] [4]
• Extended the Tethys model and related data loading functions to support a bounds parameter for spatial cropping, enabling users to specify geographic subsetting for input data and region maps. [1] [2] [3] [4] [5] [6] [7] [8]

Dependency and Installation Updates:

• Updated core and development dependencies in setup.py for improved reproducibility and compatibility, including pinning versions and adding missing dependencies for testing and documentation.
• Corrected the package installation command in documentation from pip install tethys-downscale to pip install tethys-downscaling for consistency. [1] [2]

Documentation Improvements:

• Expanded and clarified the user guide and configuration file documentation, especially regarding new options and YAML structure. [1] [2] [3]
• Updated project authorship in documentation and metadata. [1] [2]

Code Quality and Functionality Fixes:

• Improved the easy_query function to allow replacing default filters, and enhanced region data extraction utilities. [1] [2] [3]
• Fixed and streamlined spatial data loading, chunking, and regridding logic for better performance and flexibility. [1] [2] [3] [4] [5] [6]

Continuous Integration and Workflow Updates:

• Improved GitHub Actions workflows to test across multiple Python versions, update action versions, and refine triggers for the paper build workflow. [1] [2] [3]

Other Notable Changes:

• Bumped the project version to 2.2.0.
• Minor fixes and cleanups in data extraction and region mapping logic. [1] [2] [3]