Skip to main content
https://github.com/mikofski/SolarUtils/actions/workflows/python-test.yml/badge.svg

SolarUtils is set of Python wrappers around the publicly available NREL SOLPOS and SPECTRL2 C-language computer programs that calculate solar position and spectral decomposition. Please read the NREL disclaimer and license. Usage of this software implies acceptance of the terms.

Installation

Use pip to install SolarUtils from the PyPI:

pip install SolarUtils

You can also download a source distribution from PyPI or clone the repository and use Python distutils:

python setup.py install

Requirements

SolarUtils has no requirements for usage however for installation, testing and to build the documentaiton you will need the following pacakges:

  • NumPy

  • PyTest

  • Sphinx

Usage

See SOLPOS Documentation and SPECTRL2 Documentation for more detail.

Examples

>>> from solar_utils import *
>>> import pandas as pd
>>> location = [35.56836, -119.2022, -8.0]
>>> datetime = [2013, 6, 5, 12, 31, 0]
>>> weather = [1015.62055, 40.0]
>>> (angles, airmass) = solposAM(location, datetime, weather)
>>> zenith, azimuth = angles
>>> zenith
15.074043273925781
>>> azimuth
213.29042053222656]
>>> am, amp = airmass
>>> am
1.0352272987365723
>>> amp
1.0379053354263306]
>>> units = 1
>>> location = [33.65, -84.43, -5.0]
>>> datetime = [1999, 7, 22, 9, 45, 37]
>>> weather = [1006.0, 27.0]
>>> orientation = [33.65, 135.0]
>>> atmospheric_conditions = [1.14, 0.65, -1.0, 0.2, 1.36]
>>> albedo = [0.3, 0.7, 0.8, 1.3, 2.5, 4.0] + ([0.2] * 6)
>>> specdif, specdir, specetr, specglo, specx = spectrl2(
...     units, location, datetime, weather, orientation,
...     atmospheric_conditions, albedo
... )
>>> spec = pd.DataFrame(
...     {'DIF': specdif, 'DIR': specdir, 'ETR': specetr, 'GLO': specglo},
...     index=specx
... )
>>> f = spec.plot()
>>> f.set_title('Solar Spectrum Example')
>>> f.set_xlabel('Wavelength, $\lambda [\mu m]$')
>>> f.set_ylabel('Spectral Irradiance, $I_{\lambda} [W/m^2/\mu m]$')
>>> f.grid(True)
>>> f.figure.show()

Metadata

Release files for SolarUtils 0.4.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for SolarUtils 0.4.8
File Size Uploaded Provenance
solarutils-0.4.8.tar.gz 290.9 kB With provenance Details

Built distributions (wheels)

Table of built distributions (wheels) for SolarUtils 0.4.8
File
solarutils-0.4.8-cp314-cp314-win_amd64.whl CPython 3.14 CPython 3.14 Windows x86-64 Details
solarutils-0.4.8-cp314-cp314-macosx_10_15_universal2.whl CPython 3.14 CPython 3.14 macOS 10.15+ universal2 (ARM64, x86-64) Details
solarutils-0.4.8-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details
solarutils-0.4.8-cp313-cp313-macosx_10_13_universal2.whl CPython 3.13 CPython 3.13 macOS 10.13+ universal2 (ARM64, x86-64) Details
solarutils-0.4.8-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details
solarutils-0.4.8-cp312-cp312-macosx_10_13_universal2.whl CPython 3.12 CPython 3.12 macOS 10.13+ universal2 (ARM64, x86-64) Details
solarutils-0.4.8-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details
solarutils-0.4.8-cp311-cp311-macosx_10_9_universal2.whl CPython 3.11 CPython 3.11 macOS 10.9+ universal2 (ARM64, x86-64) Details
solarutils-0.4.8-cp310-cp310-win_amd64.whl CPython 3.10 CPython 3.10 Windows x86-64 Details
solarutils-0.4.8-cp310-cp310-macosx_10_9_universal2.whl CPython 3.10 CPython 3.10 macOS 10.9+ universal2 (ARM64, x86-64) Details

Total release size: 736.2 kB

Release files / solarutils-0.4.8.tar.gz

Download URL solarutils-0.4.8.tar.gz
Size 290.9 kB
Tags Source
SHA-256 checksum
How to use checksums
f2ad9fe2e284c51a8378bcb12f94d0cb2d55c91f28529bf0d70853ca49152a1c
BLAKE2b-256 checksum
How to use checksums
adf057764c322f36678abec0ac4567503c58916163e3dbc1d40ba912adbd73e7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / solarutils-0.4.8-cp314-cp314-win_amd64.whl

Download URL solarutils-0.4.8-cp314-cp314-win_amd64.whl
Size 40.7 kB
Tags CPython 3.14 Windows x86-64
SHA-256 checksum
How to use checksums
25132dc890c0ce70bdc4623472ca97d30a5d99a9b747d7b0c18e39eedb9fa13a
BLAKE2b-256 checksum
How to use checksums
7e1a02ca7220b214a62ebb9eb64fbd5835dbf3131e50fc570691fc81f6161a36
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / solarutils-0.4.8-cp314-cp314-macosx_10_15_universal2.whl

Download URL solarutils-0.4.8-cp314-cp314-macosx_10_15_universal2.whl
Size 50.4 kB
Tags CPython 3.14 macOS 10.15+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
c6ec9622c2f87f3d12116ff399b39125e02298ec38602826358677d29a1eea62
BLAKE2b-256 checksum
How to use checksums
ba51dfff7683927bb24e32f5b30aac19113470133ce75f0a3132ad62fc299300
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / solarutils-0.4.8-cp313-cp313-win_amd64.whl

Download URL solarutils-0.4.8-cp313-cp313-win_amd64.whl
Size 39.9 kB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
857ca912c4633c8dc35bc2da7ea69692564a19163397436a1809b21ab40279d4
BLAKE2b-256 checksum
How to use checksums
84e4a2cfae23589f966d38ead5683b18d539acd37233a2b8cef1e3175de80fe1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / solarutils-0.4.8-cp313-cp313-macosx_10_13_universal2.whl

Download URL solarutils-0.4.8-cp313-cp313-macosx_10_13_universal2.whl
Size 48.6 kB
Tags CPython 3.13 macOS 10.13+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
bb9203eaf981ac5cad570dd34085688164c7c812ada2f764056ba2d5e579c6e9
BLAKE2b-256 checksum
How to use checksums
391e673ee18c923c44b97dcbe394d52c5b3060fecb37ab1bdeeb408af87bb147
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / solarutils-0.4.8-cp312-cp312-win_amd64.whl

Download URL solarutils-0.4.8-cp312-cp312-win_amd64.whl
Size 39.9 kB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
4fab94f15c795e4d4679af5a9e4eb22d82bcc08f066f9e001fa42f388586133d
BLAKE2b-256 checksum
How to use checksums
3ddcc46878825f8724d8b3a5ae837214baa0cf476186a9fc25f8481cead55efc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / solarutils-0.4.8-cp312-cp312-macosx_10_13_universal2.whl

Download URL solarutils-0.4.8-cp312-cp312-macosx_10_13_universal2.whl
Size 48.6 kB
Tags CPython 3.12 macOS 10.13+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
5eeeaf3097caa239bfeaa47eb6765a65ededbe6c27e5626f15149e3efab64a4e
BLAKE2b-256 checksum
How to use checksums
9d8f24d803858cbde74d52e628bb047b02666c2aefee83e4c394db15fa2d3011
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / solarutils-0.4.8-cp311-cp311-win_amd64.whl

Download URL solarutils-0.4.8-cp311-cp311-win_amd64.whl
Size 39.9 kB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
a52ce12d72266bc4f82ea0f5e93c1a5ee0e8bf2b57e1387322df1e518c622158
BLAKE2b-256 checksum
How to use checksums
1955e207d4855c6ad338dd823c064396bb2cd86c2c1dd13a15e3ff06b837e2a2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / solarutils-0.4.8-cp311-cp311-macosx_10_9_universal2.whl

Download URL solarutils-0.4.8-cp311-cp311-macosx_10_9_universal2.whl
Size 48.7 kB
Tags CPython 3.11 macOS 10.9+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
5bf07ceefa638954e2b0bfc8fdcd56780c563295ee77411840eeb105f2863b09
BLAKE2b-256 checksum
How to use checksums
6214ef7a2055c05255d303e68dd919617d085bb4c511fb327114248aaffca1cf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / solarutils-0.4.8-cp310-cp310-win_amd64.whl

Download URL solarutils-0.4.8-cp310-cp310-win_amd64.whl
Size 39.9 kB
Tags CPython 3.10 Windows x86-64
SHA-256 checksum
How to use checksums
50770751195a1de79b122e081d6e0389fd0a64a7ca083f8047ea3a3c85876d17
BLAKE2b-256 checksum
How to use checksums
b264670691a72758a7823bba5aeb64f7c0bf9c8eaa8b79986d32fc8d93db9e90
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / solarutils-0.4.8-cp310-cp310-macosx_10_9_universal2.whl

Download URL solarutils-0.4.8-cp310-cp310-macosx_10_9_universal2.whl
Size 48.7 kB
Tags CPython 3.10 macOS 10.9+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
72c247ee7422a93c0ffb9db353d29131733a4493bbcd08479186bca1fe808307
BLAKE2b-256 checksum
How to use checksums
40bafb6363162d3d22e74038d22e0d6b166b55b611a8b9a92c63a3419f1cc9bb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Security for SolarUtils 0.4.8

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 11 files in this release have been uploaded with provenance metadata.

Select from 11 files

Attestation for solarutils-0.4.8.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page