Skip to content

Organize iotools reference page by data provider #2447

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
May 27, 2025
Merged

Organize iotools reference page by data provider #2447

Changes from 1 commit
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
919a921
split up iotools ref page by data provider/source
kandersolar Apr 23, 2025
7fbb9b6
Update docs/sphinx/source/reference/iotools.rst
kandersolar May 23, 2025
084347d
reorganize, add blurbs
kandersolar May 23, 2025
f405613
expand the blurbs
kandersolar May 23, 2025
1aacc49
Apply suggestions from code review
kandersolar May 23, 2025
bb4aad3
Merge remote-tracking branch 'upstream/main' into iotools_doc_org
kandersolar May 23, 2025
d7a356b
Merge branch 'iotools_doc_org' of https://github.com/kandersolar/pvli…
kandersolar May 23, 2025
76d96d4
add line about commercial data spatial coverage
kandersolar May 27, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
157 changes: 136 additions & 21 deletions docs/sphinx/source/reference/iotools.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,21 +11,39 @@ IO Tools
Functions for retrieving, reading, and writing data from a variety
of sources and file formats relevant to solar energy modeling.

Public datasets
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You could consider adding to the description the timestep of each dataframe

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I do think this would be helpful to many readers, but I am reluctant to include much dataset-specific information on this page. If we include time step, do we also mention which variables are offered, the date range, the spatial resolution...

I think listing just geographic coverage is a good compromise. It lets people identify broadly what datasets may be useful for them, and they can read the function pages to get details for individual datasets.

---------------

PVGIS
^^^^^

.. autosummary::
:toctree: generated/

iotools.get_pvgis_tmy
iotools.read_pvgis_tmy
iotools.get_pvgis_hourly
iotools.read_pvgis_hourly
iotools.get_pvgis_horizon


CAMS
^^^^

.. autosummary::
:toctree: generated/

iotools.get_cams
iotools.read_cams
iotools.parse_cams


NSRDB
^^^^^

.. autosummary::
:toctree: generated/

iotools.read_tmy2
iotools.read_tmy3
iotools.read_epw
iotools.parse_epw
iotools.read_srml
iotools.get_srml
iotools.read_surfrad
iotools.read_midc
iotools.read_midc_raw_data_from_nrel
iotools.read_crn
iotools.read_solrad
iotools.get_solrad
iotools.get_nsrdb_psm4_aggregated
iotools.get_nsrdb_psm4_tmy
iotools.get_nsrdb_psm4_conus
Expand All @@ -35,32 +53,129 @@ of sources and file formats relevant to solar energy modeling.
iotools.get_psm3
iotools.read_psm3
iotools.parse_psm3
iotools.get_pvgis_tmy
iotools.read_pvgis_tmy
iotools.get_pvgis_hourly
iotools.read_pvgis_hourly
iotools.get_pvgis_horizon


BSRN
^^^^

.. autosummary::
:toctree: generated/

iotools.get_bsrn
iotools.read_bsrn
iotools.parse_bsrn
iotools.get_cams
iotools.read_cams
iotools.parse_cams


SOLRAD
^^^^^^

.. autosummary::
:toctree: generated/

iotools.read_solrad
iotools.get_solrad


SURFRAD
^^^^^^^

.. autosummary::
:toctree: generated/

iotools.read_surfrad


MIDC
^^^^

.. autosummary::
:toctree: generated/

iotools.read_midc
iotools.read_midc_raw_data_from_nrel


SRML
^^^^

.. autosummary::
:toctree: generated/

iotools.read_srml
iotools.get_srml


ACIS
^^^^

.. autosummary::
:toctree: generated/

iotools.get_acis_prism
iotools.get_acis_nrcc
iotools.get_acis_mpe
iotools.get_acis_station_data
iotools.get_acis_available_stations
iotools.read_panond


CRN
^^^

.. autosummary::
:toctree: generated/

iotools.read_crn



Commercial datasets
-------------------


SolarAnywhere
^^^^^^^^^^^^^

.. autosummary::
:toctree: generated/

iotools.get_solaranywhere
iotools.read_solaranywhere


Solcast
^^^^^^^

.. autosummary::
:toctree: generated/

iotools.get_solcast_tmy
iotools.get_solcast_historic
iotools.get_solcast_forecast
iotools.get_solcast_live


Solargis
^^^^^^^^

.. autosummary::
:toctree: generated/

iotools.get_solargis


Generic data file readers
-------------------------

.. autosummary::
:toctree: generated/

iotools.read_tmy2
iotools.read_tmy3
iotools.read_epw
iotools.parse_epw
iotools.read_panond


A :py:class:`~pvlib.location.Location` object may be created from metadata
in some files.

Expand Down
Loading