Skip to content

Data pvlib integration - #104

Open
KULcoder wants to merge 103 commits into
GeodataTools:dataset-refactorfrom
KULcoder:data-pvlib-integration
Open

Data pvlib integration#104
KULcoder wants to merge 103 commits into
GeodataTools:dataset-refactorfrom
KULcoder:data-pvlib-integration

Conversation

@KULcoder

@KULcoder KULcoder commented Feb 6, 2026

Copy link
Copy Markdown

A branch that integrated the Pvlib branch into the refactored dataset branch.

Keyu Long and others added 30 commits December 1, 2025 16:13
Adding a new testing file for PR
following the lint style check
fix: modify the test file, such that it allows the tolerance for xr.s…
…um_scales (return value <0) occur on the workflow
…modify _make_interp_coeff"

This reverts commit b3c1816.
KULcoder and others added 27 commits February 10, 2026 11:31
Integrate pvlib new: fix the x/y sequence issue
Two important features:
1. Forcing the wind model (interpolation) and solar model (pvlib) to have the same coordinate system (time, x, y).
2. Uploading a fixture for workload testing (bypassing the secret testing), but this means we will not be able to test the downloading feature.
feat: adding a compact output parameter for pvlib estimate, to remove or keep the output columns
…ation model (adding this function to the public space)
fix: debugging the sequential bug for x/y order for the wind-interpol…
- Introduced `XarrayMask` class for direct application of masks to xarray datasets.
- Added migration plan documentation detailing phases for transitioning from Cutout-based masking.
- Implemented shared spatial helper utilities for coarsening and area calculations.
- Established tests to ensure legacy behavior is preserved during the migration.
- Updated package structure to support new xarray functionalities while maintaining backward compatibility.
- Simplified import statements by directly importing necessary functions from the mask.spatial module.
- Removed unused functions related to dataset reformatting and coarsening to clean up the codebase.
- Updated the `__all__` variable to include `ds_reformat_index` for better module export consistency.
feat: implement xarray-based masking workflow and migration plan
…ataset management

- Added troubleshooting documentation for `merge_layer` errors related to in-memory layers.
- Refactored dataset closing logic to ensure proper management of in-memory `MemoryFile` instances.
- Introduced new helper functions for opening and closing datasets to streamline memory management.
- Added regression tests for merging in-memory layers to validate functionality and prevent future issues.
feat: enhance mask module with in-memory layer support and improved d…
- Added a new section for the legacy workflow in the documentation, detailing the original API and its usage.
- Created a dedicated organization plan for documentation to clarify structure and user journeys.
- Improved the introduction and overview sections to guide users towards the modern workflow.
- Updated various documentation files to reflect changes in the API and user guidance.
- Completed documentation for `compact_output` in the PVLib model, clarifying its default behavior and usage.
- Enhanced the wind modeling documentation to include detailed estimate options for spatial and temporal subsetting, addressing slice order behavior on descending latitude grids.
- Updated various sections across modeling documentation to ensure consistency and clarity regarding estimation methods and parameters.
- Added `xarray_mask_tutorial.ipynb` to the documentation under the `mask/` directory, ensuring it is included in the toctree.
- Updated `xarray_mask_workflow.rst` to reference the new tutorial, providing users with a step-by-step guide for the xarray masking workflow.
- Clarified documentation structure to enhance navigation and accessibility of resources.
- Updated the wind modeling documentation to clarify the estimation of wind turbine capacity factors (CF) using both interpolation and extrapolation models.
- Improved explanations for the `estimate` method and the output structure, ensuring users understand how to utilize the available wind turbine models effectively.
- Revised the toctree entries and documentation structure to enhance navigation and consistency across modeling resources.
- Removed MERRA2-specific tutorials from the main documentation and relocated them to a legacy section, clarifying that MERRA2 is only supported through the legacy API.
- Updated references in the documentation to guide users towards the new structure and legacy resources.
- Enhanced the organization of the documentation to improve navigation and accessibility for users transitioning from the legacy API.
- Modified the Read the Docs configuration to avoid memory issues by installing only necessary dependencies for documentation.
- Updated the Sphinx configuration to read the project version from a file without importing the main package, ensuring compatibility with RTD's no-deps installation.
- Improved the overall structure of the documentation build process for better efficiency.
- Updated the `index.rst` to include specific mask tutorials and troubleshooting documentation, enhancing the structure of the mask section.
- Renamed references in the `intro.rst` to point to the new `xarray_mask_tutorial` for clarity.
- Removed the obsolete `mask_xarray_migration_plan.md` and updated the documentation to reflect the new organization of mask-related resources.
- Enhanced the `xarray_mask_tutorial.ipynb` to provide clearer guidance on using the xarray-based masking workflow, including updated links to relevant documentation.
- Deleted the `xarray_mask_workflow.rst` as part of the documentation restructuring.
- Revised the ERA5 documentation to emphasize the recommended method for downloading data via Geodata, reducing the need for direct `cdsapi` calls.
- Clarified the steps for setting up a CDS account and configuring API credentials, ensuring users understand the process.
- Enhanced examples for downloading ERA5 data, including specific use cases for 3D wind and 2D wind/solar datasets.
- Added links to relevant sections for offline development and CI without CDS, improving accessibility to fixture datasets.
- Updated the overview section to provide a clearer structure and guidance for users navigating ERA5 data management.
…orial

- Enhanced the wind modeling documentation to clarify the usage of the `geodata.model.wind` module and its capabilities for estimating wind speed.
- Updated references in the `intro.rst` to reflect changes in wind modeling terminology and improved clarity on interpolation and turbine capacity factor estimation.
- Removed the outdated `extrapolation.rst` tutorial, consolidating information to streamline the documentation structure.
- Added new sections in the `index.rst` and `quick_start` to improve navigation and accessibility of wind-related resources.
- Added a reference to the new `modeling/era5_outputs` section in the `index.rst` for improved navigation.
- Deleted the outdated `era5_outputs.md` file, consolidating information to streamline the documentation.
- Updated links in the `quick_start/input_output.md` to point to the new modeling outputs, ensuring users have access to the latest resources.
@KULcoder
KULcoder marked this pull request as ready for review June 9, 2026 22:03
KULcoder and others added 2 commits June 9, 2026 19:04
- Deleted several outdated Jupyter notebooks, including `mask_on_cutout.ipynb`, `merra2.ipynb`, `mask_creation_workflow.ipynb`, `xarray_mask_tutorial.ipynb`, and `visualization.ipynb`, to streamline the documentation and remove redundant content.
- This cleanup enhances the clarity and focus of the documentation, ensuring users have access to relevant and up-to-date resources.
docs: remove obsolete Jupyter notebooks from documentation
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant