SolarUtils 0.4.8__cp313-cp313-win_amd64.whl

solar_utils/NREL_DISCLAIMERS-COPYRIGHTS-LICENSES.txt

@@ -0,0 +1,60 @@
+Disclaimer
+The National Renewable Energy Laboratory (NREL) is operated for the U.S. 
+Department of Energy by the Alliance for Sustainable Energy, LLC 
+("Alliance"). As such the following rules apply:
+
+Copyright Status
+NREL-authored documents are sponsored by the U.S. Department of Energy under 
+Contract DE-AC36-08GO28308. Accordingly, with respect to such documents, the 
+U.S. Government and others acting on its behalf retain a paid-up 
+nonexclusive, irrevocable world-wide license to reproduce, prepare derivative 
+works, distribute copies to the public, and perform publicly and display 
+publicly, by or on behalf of the Government. Use of documents available from 
+or referenced by this server may be subject to U.S. and foreign Copyright Laws.
+
+Disclaimer of Endorsement
+Reference herein to any specific commercial products, process, or service by 
+trade name, trademark, manufacturer, or otherwise, does not necessarily 
+constitute or imply its endorsement, recommendation, or favoring by the 
+United States Government or Alliance . The views and opinions of authors 
+expressed in the available or referenced documents do not necessarily state 
+or reflect those of the United States Government or Alliance.
+
+Disclaimer of Liability
+WITH RESPECT TO INFORMATION FROM THIS SERVER, NEITHER THE UNITED STATES 
+GOVERNMENT NOR ALLIANCE, NOR ANY OF THEIR EMPLOYEES, MAKES ANY WARRANTY, 
+EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS 
+FOR A PARTICULAR PURPOSE, OR ASSUMES ANY LEGAL LIABILITY OR RESPONSIBILITY 
+FOR THE ACCURACY, COMPLETENESS, OR USEFULNESS OF ANY SUCH INFORMATION, OR OF 
+ANY APPARATUS, PRODUCT, OR PROCESS DISCLOSED, OR REPRESENTS THAT ITS USE 
+WOULD NOT INFRINGE PRIVATELY OWNED RIGHTS.
+
+Data and Software
+Access to or use of any data or software made available on this server 
+("Data") shall impose the following obligations on the user, and use of the 
+Data constitutes user's agreement to these terms. The user is granted the 
+right, without any fee or cost, to use or copy the Data, provided that this 
+entire notice appears in all copies of the Data.  Further, the user agrees to 
+credit the U.S. Department of Energy (DOE)/NREL/ALLIANCE in any publication 
+that results from the use of the Data.  The names DOE/NREL/ALLIANCE, however, 
+may not be used in any advertising or publicity to endorse or promote any 
+products or commercial entities unless specific written permission is 
+obtained from DOE/NREL/ ALLIANCE.  The user also understands that 
+DOE/NREL/ALLIANCE are not obligated to provide the user with any support, 
+consulting, training or assistance of any kind with regard to the use of the 
+Data or to provide the user with any updates, revisions or new versions 
+thereof. DOE, NREL, and ALLIANCE do not guarantee or endorse any results 
+generated by use of the Data, and user is entirely responsible for the 
+results and any reliance on the results or the Data in general.
+
+USER AGREES TO INDEMNIFY DOE/NREL/ALLIANCE AND ITS SUBSIDIARIES, AFFILIATES, 
+OFFICERS, AGENTS, AND EMPLOYEES AGAINST ANY CLAIM OR DEMAND, INCLUDING 
+REASONABLE ATTORNEYS' FEES, RELATED TO USER’S USE OF THE DATA.  THE DATA ARE 
+PROVIDED BY DOE/NREL/ALLIANCE "AS IS," AND ANY EXPRESS OR IMPLIED WARRANTIES, 
+INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 
+FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL 
+DOE/NREL/ALLIANCE BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL 
+DAMAGES OR ANY DAMAGES WHATSOEVER, INCLUDING BUT NOT LIMITED TO CLAIMS 
+ASSOCIATED WITH THE LOSS OF DATA OR PROFITS, THAT MAY RESULT FROM AN ACTION 
+IN CONTRACT, NEGLIGENCE OR OTHER TORTIOUS CLAIM THAT ARISES OUT OF OR IN 
+CONNECTION WITH THE ACCESS, USE OR PERFORMANCE OF THE DATA.

solar_utils/__init__.py

@@ -0,0 +1,15 @@
+# -*- coding: utf-8 -*-
+"""
+This is the solar utilities package.
+
+2026 Mark Mikofski
+"""
+
+from solar_utils.core import solposAM, spectrl2, get_solpos8760, get_solposAM
+
+__version__ = '0.4.8'
+__release__ = 'Dentists'
+__author__ = 'Mark Mikofski'
+__email__ = 'bwana.marko@yahoo.com'
+__url__ = 'https://github.com/mikofski/SolarUtils'
+__all__ = ['solposAM', 'spectrl2', 'get_solpos8760', 'get_solposAM']

solar_utils/core.py

@@ -0,0 +1,301 @@
+# -*- coding: utf-8 -*-
+"""
+Solar utilities based on `SOLPOS
+<http://rredc.nrel.gov/solar/codesandalgorithms/solpos/>`_ and `SPECTRL2
+<http://rredc.nrel.gov/solar/models/spectral/>`_ from
+`NREL RREDC Solar Resource Models and Tools
+<http://www.nrel.gov/rredc/models_tools.html>`_
+
+2026 Mark Mikofski
+"""
+
+import ctypes
+import datetime as pydatetime
+import math
+import os
+import sys
+from solar_utils.exceptions import SOLPOS_Error, SPECTRL2_Error
+
+_DIRNAME = os.path.dirname(__file__)
+PLATFORM = sys.platform
+if PLATFORM == 'win32':
+    SOLPOSAM = 'solposAM.dll'
+    SPECTRL2 = 'spectrl2.dll'
+elif PLATFORM in ['linux2', 'linux']:
+    PLATFORM = 'linux'
+    SOLPOSAM = 'libsolposAM.so'
+    SPECTRL2 = 'libspectrl2.so'
+elif PLATFORM == 'darwin':
+    SOLPOSAM = 'libsolposAM.dylib'
+    SPECTRL2 = 'libspectrl2.dylib'
+else:
+    raise OSError('Platform "%s" is unknown or unsupported.' % PLATFORM)
+SOLPOSAMDLL = os.path.join(_DIRNAME, SOLPOSAM)
+SPECTRL2DLL = os.path.join(_DIRNAME, SPECTRL2)
+
+
+def _int2bits(err_code):
+    """
+    Convert integer to bits.
+
+    :param err_code: integer to convert
+    :returns: log(err_code, 2)
+    """
+    return int(math.log(err_code, 2))
+
+
+def get_solpos8760(location, year, weather):
+    """
+    Get SOLPOS hourly calculation for specified non-leap year.
+
+    :param location: [latitude, longitude, UTC-timezone]
+    :type location: float
+    :param year: a non-leap year
+    :type year: int
+    :param weather: [ambient-pressure (mB), ambient-temperature (C)]
+    :type weather: float
+    :returns: angles [degrees], airmass [atm]
+    :rtype: float
+    :raises: :exc:`~solar_utils.exceptions.SOLPOS_Error`
+
+    **Example:**
+
+    >>> location = [35.56836, -119.2022, -8.0]
+    >>> weather = [1015.62055, 40.0]
+    >>> angles, airmass = get_solpos8760(location, 2013, weather)
+    """
+    datetimes = [
+        (pydatetime.datetime(year, 1, 1, 0, 0, 0)
+         + pydatetime.timedelta(hours=h)).timetuple()[:6]
+        for h in range(8760)]
+    return get_solposAM(location, datetimes, weather)
+
+
+def get_solposAM(location, datetimes, weather):
+    """
+    Get SOLPOS hourly calculation for sequence of datetimes.
+
+    :param location: [latitude, longitude, UTC-timezone]
+    :type location: float
+    :param datetimes: [year, month, day, hour, minute, second]
+    :type datetimes: int
+    :param weather: [ambient-pressure (mB), ambient-temperature (C)]
+    :type weather: float
+    :returns: angles [degrees], airmass [atm]
+    :rtype: float
+    :raises: :exc:`~solar_utils.exceptions.SOLPOS_Error`
+
+    **Example:**
+
+    >>> location = [35.56836, -119.2022, -8.0]
+    >>> datetimes = [
+    ...     (datetime.datetime(2013, 1, 1, 0, 0, 0)
+    ...      + datetime.timedelta(hours=h)).timetuple()[:6]
+    ...     for h in range(1000)]
+    >>> weather = [1015.62055, 40.0]
+    >>> angles, airmass = get_solposAM(location, datetimes, weather)
+    """
+    count = len(datetimes)
+    # load the DLL
+    solposAM_dll = ctypes.cdll.LoadLibrary(SOLPOSAMDLL)
+    _get_solposAM = solposAM_dll.get_solposAM
+    # cast Python types as ctypes
+    _location = (ctypes.c_float * 3)(*location)
+    _datetime = ((ctypes.c_int * 6) * count)(*datetimes)
+    _weather = (ctypes.c_float * 2)(*weather)
+    # allocate space for results
+    angles = ((ctypes.c_float * 2) * count)()
+    airmass = ((ctypes.c_float * 2) * count)()
+    settings = ((ctypes.c_int * 2) * count)()
+    orientation = ((ctypes.c_float * 2) * count)()
+    shadowband = ((ctypes.c_float * 3) * count)()
+    err_code = (ctypes.c_long * count)()
+    # call
+    retval = _get_solposAM(
+        _location, _datetime, _weather, count, angles, airmass, settings,
+        orientation, shadowband, err_code)
+    if (retval != 0): raise RuntimeError('solposAM did not execute')
+    if all(ec == 0 for ec in err_code):
+        return angles, airmass
+    else:
+        for n, ec in enumerate(err_code):
+            if ec == 0: continue
+            # convert err_code to bits
+            _code = _int2bits(ec)
+            data = {'location': location,
+                    'datetime': datetimes[n],
+                    'weather': weather,
+                    'angles': angles[n],
+                    'airmass': airmass[n],
+                    'settings': settings[n],
+                    'orientation': orientation[n],
+                    'shadowband': shadowband[n]}
+            raise SOLPOS_Error(_code, data)
+
+
+def solposAM(location, datetime, weather):
+    """
+    Calculate solar position and air mass by calling functions exported by
+    :data:`SOLPOSAMDLL`.
+
+    :param location: [latitude, longitude, UTC-timezone]
+    :type location: float
+    :param datetime: [year, month, day, hour, minute, second]
+    :type datetime: int
+    :param weather: [ambient-pressure (mB), ambient-temperature (C)]
+    :type weather: float
+    :returns: angles [degrees], airmass [atm]
+    :rtype: float
+    :raises: :exc:`~solar_utils.exceptions.SOLPOS_Error`
+
+    Returns the solar zenith and azimuth angles in degrees, as well as the
+    relative and absolute (or pressure corrected) air mass.
+
+    **Examples:**
+
+    >>> 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)
+    >>> list(angles)
+    [15.074043273925781, 213.29042053222656]
+    >>> list(airmass)
+    [1.0352272987365723, 1.0379053354263306]
+    """
+    # load the DLL
+    solposAM_dll = ctypes.cdll.LoadLibrary(SOLPOSAMDLL)
+    _solposAM = solposAM_dll.solposAM
+    # cast Python types as ctypes
+    _location = (ctypes.c_float * 3)(*location)
+    _datetime = (ctypes.c_int * 6)(*datetime)
+    _weather = (ctypes.c_float * 2)(*weather)
+    # allocate space for results
+    angles = (ctypes.c_float * 2)()
+    airmass = (ctypes.c_float * 2)()
+    settings = (ctypes.c_int * 2)()
+    orientation = (ctypes.c_float * 2)()
+    shadowband = (ctypes.c_float * 3)()
+    # call DLL
+    err_code = _solposAM(_location, _datetime, _weather, angles, airmass,
+                         settings, orientation, shadowband)
+    # return results if successful, otherwise raise SOLPOS_Error
+    if err_code == 0:
+        return angles, airmass
+    else:
+        # convert err_code to bits
+        _code = _int2bits(err_code)
+        data = {'location': location,
+                'datetime': datetime,
+                'weather': weather,
+                'angles': angles,
+                'airmass': airmass,
+                'settings': settings,
+                'orientation': orientation,
+                'shadowband': shadowband}
+        raise SOLPOS_Error(_code, data)
+
+
+def spectrl2(units, location, datetime, weather, orientation,
+             atmospheric_conditions, albedo):
+    """
+    Calculate solar spectrum by calling functions exported by
+    :data:`SPECTRL2DLL`.
+
+    :param units: set ``units`` = 1 for W/m:sup:`2`/micron
+    :type units: int
+    :param location: latitude, longitude and UTC-timezone
+    :type location: float
+    :param datetime: year, month, day, hour, minute and second
+    :type datetime: int
+    :param weather: ambient-pressure [mB] and ambient-temperature [C]
+    :type weather: float
+    :param orientation: tilt and aspect [degrees]
+    :type orientation: float
+    :param atmospheric_conditions: alpha, assym, ozone, tau500 and watvap
+    :type atmospheric_conditions: float
+    :param albedo: 6 wavelengths and 6 reflectivities
+    :type albedo: float
+    :returns: spectral decomposition, x-coordinate
+    :rtype: float
+    :raises: :exc:`~solar_utils.exceptions.SPECTRL2_Error`,
+        :exc:`~solar_utils.exceptions.SOLPOS_Error`
+
+    Returns the diffuse, direct, extraterrestrial and global spectral components
+    on the tilted surface in as a function of x-coordinate specified by units.
+
+    =====  ===============================================================
+    units  output units
+    =====  ===============================================================
+    1      irradiance (W/sq m/micron) per wavelength (microns)
+    2      photon flux (10.0E+16 /sq cm/s/micron) per wavelength (microns)
+    3      photon flux density (10.0E+16 /sq cm/s/eV) per energy (eV)
+    =====  ===============================================================
+
+    See
+    `NREL SPECTRL2 Documentation <http://rredc.nrel.gov/solar/models/spectral/spectrl2/documentation.html>`_
+    for more detail.
+
+    .. seealso::
+        :func:`solposAM`
+
+    **Examples:**
+
+    >>> 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)
+    """
+    # load the DLL
+    ctypes.cdll.LoadLibrary(SOLPOSAMDLL)  # requires 'solpos.dll'
+    spectrl2_dll = ctypes.cdll.LoadLibrary(SPECTRL2DLL)
+    _spectrl2 = spectrl2_dll.spectrl2
+    # cast Python types as ctypes
+    _location = (ctypes.c_float * 3)(*location)
+    _datetime = (ctypes.c_int * 6)(*datetime)
+    _weather = (ctypes.c_float * 2)(*weather)
+    _orientation = (ctypes.c_float * 2)(*orientation)
+    _atmospheric_conditions = (ctypes.c_float * 5)(*atmospheric_conditions)
+    _albedo = (ctypes.c_float * 12)(*albedo)
+    # allocate space for results
+    specdif = (ctypes.c_float * 122)()
+    specdir = (ctypes.c_float * 122)()
+    specetr = (ctypes.c_float * 122)()
+    specglo = (ctypes.c_float * 122)()
+    specx = (ctypes.c_float * 122)()
+    angles = (ctypes.c_float * 2)()
+    airmass = (ctypes.c_float * 2)()
+    settings = (ctypes.c_int * 2)()
+    shadowband = (ctypes.c_float * 3)()
+    # call DLL
+    err_code = _spectrl2(
+        units, _location, _datetime, _weather, _orientation,
+        _atmospheric_conditions, _albedo, specdif, specdir, specetr, specglo,
+        specx, angles, airmass, settings, shadowband
+    )
+    # return results if successful, otherwise raise exception
+    if err_code == 0:
+        return specdif, specdir, specetr, specglo, specx
+    elif err_code < 0:
+        data = {'units': units,
+                'tau500': atmospheric_conditions[3],
+                'watvap': atmospheric_conditions[4],
+                'assym': atmospheric_conditions[1]}
+        raise SPECTRL2_Error(err_code, data)
+    else:
+        # convert err_code to bits
+        _code = _int2bits(err_code)
+        data = {'location': location,
+                'datetime': datetime,
+                'weather': weather,
+                'angles': angles,
+                'airmass': airmass,
+                'settings': settings,
+                'orientation': orientation,
+                'shadowband': shadowband}
+        raise SOLPOS_Error(_code, data)

solar_utils/exceptions.py

@@ -0,0 +1,122 @@
+# -*- coding: utf-8 -*-
+"""
+Exceptions for solar utilities.
+
+2026 Mark Mikofski
+"""
+
+
+class SolarUtilsException(Exception):
+    """
+    Base exception class for solar_utils.
+    """
+    pass
+
+
+class SOLPOS_Error(SolarUtilsException):
+    """
+    SOLPOS Errors
+    """
+    S_CODE = ['S_YEAR_ERROR',
+              'S_MONTH_ERROR',
+              'S_DAY_ERROR',
+              'S_DOY_ERROR',
+              'S_HOUR_ERROR',
+              'S_MINUTE_ERROR',
+              'S_SECOND_ERROR',
+              'S_TZONE_ERROR',
+              'S_INTRVL_ERROR',
+              'S_LAT_ERROR',
+              'S_LON_ERROR',
+              'S_TEMP_ERROR',
+              'S_PRESS_ERROR',
+              'S_TILT_ERROR',
+              'S_ASPECT_ERROR',
+              'S_SBWID_ERROR',
+              'S_SBRAD_ERROR',
+              'S_SBSKY_ERROR']
+
+    def __init__(self, code, data):
+        self.args = SOLPOS_Error.S_CODE[code], data
+        self.message = str(self)
+
+    def __str__(self):
+        if self.args[0] == 'S_YEAR_ERROR':
+            errmsg = "S_decode ==> Please fix the year: %d [1950-2050]\n"
+            message = errmsg % self.args[1]['datetime'][0]
+        if self.args[0] == 'S_MONTH_ERROR':
+            errmsg = "S_decode ==> Please fix the month: %d\n"
+            message = errmsg % self.args[1]['datetime'][1]
+        if self.args[0] == 'S_DAY_ERROR':
+            errmsg = "S_decode ==> Please fix the day-of-month: %d\n"
+            message = errmsg % self.args[1]['datetime'][2]
+        if self.args[0] == 'S_HOUR_ERROR':
+            errmsg = "S_decode ==> Please fix the hour: %d\n"
+            message = errmsg % self.args[1]['datetime'][3]
+        if self.args[0] == 'S_MINUTE_ERROR':
+            errmsg = "S_decode ==> Please fix the minute: %d\n"
+            message = errmsg % self.args[1]['datetime'][4]
+        if self.args[0] == 'S_SECOND_ERROR':
+            errmsg = "S_decode ==> Please fix the second: %d\n"
+            message = errmsg % self.args[1]['datetime'][5]
+        if self.args[0] == 'S_DOY_ERROR':
+            errmsg = "S_decode ==> Please fix the day-of-year: %d\n"
+            message = errmsg % self.args[1]['settings'][0]
+        if self.args[0] == 'S_INTRVL_ERROR':
+            errmsg = "S_decode ==> Please fix the interval: %d\n"
+            message = errmsg % self.args[1]['settings'][1]
+        if self.args[0] == 'S_LAT_ERROR':
+            errmsg = "S_decode ==> Please fix the latitude: %f\n"
+            message = errmsg % self.args[1]['location'][0]
+        if self.args[0] == 'S_LON_ERROR':
+            errmsg = "S_decode ==> Please fix the longitude: %f\n"
+            message = errmsg % self.args[1]['location'][1]
+        if self.args[0] == 'S_TZONE_ERROR':
+            errmsg = "S_decode ==> Please fix the time zone: %f\n"
+            message = errmsg % self.args[1]['location'][2]
+        if self.args[0] == 'S_PRESS_ERROR':
+            errmsg = "S_decode ==> Please fix the pressure: %f\n"
+            message = errmsg % self.args[1]['weather'][0]
+        if self.args[0] == 'S_TEMP_ERROR':
+            errmsg = "S_decode ==> Please fix the temperature: %f\n"
+            message = errmsg % self.args[1]['weather'][1]
+        if self.args[0] == 'S_TILT_ERROR':
+            errmsg = "S_decode ==> Please fix the tilt: %f\n"
+            message = errmsg % self.args[1]['orientation'][0]
+        if self.args[0] == 'S_ASPECT_ERROR':
+            errmsg = "S_decode ==> Please fix the aspect: %f\n"
+            message = errmsg % self.args[1]['orientation'][1]
+        if self.args[0] == 'S_SBWID_ERROR':
+            errmsg = "S_decode ==> Please fix the shadowband width: %f\n"
+            message = errmsg % self.args[1]['shadowband'][0]
+        if self.args[0] == 'S_SBRAD_ERROR':
+            errmsg = "S_decode ==> Please fix the shadowband radius: %f\n"
+            message = errmsg % self.args[1]['shadowband'][1]
+        if self.args[0] == 'S_SBSKY_ERROR':
+            errmsg = "S_decode ==> Please fix the shadowband sky factor: %f\n"
+            message = errmsg % self.args[1]['shadowband'][2]
+        return message
+
+
+class SPECTRL2_Error(SolarUtilsException):
+    """
+    SPECTRL2 Errors
+    """
+    def __init__(self, code, data):
+        self.args = code, data
+        self.message = str(self)
+
+    def __str__(self):
+        if self.args[0] == -1:
+            errmsg = "*** S_spectral2 -> units should be 1 to 3, not %d\n"
+            message = errmsg % self.args[1]['units']
+        if self.args[0] == -2:
+            errmsg = "*** S_spectral2 -> tau500 should not be %f\n"
+            message = errmsg % self.args[1]['tau500']
+        if self.args[0] == -3:
+            errmsg = "*** S_spectral2 -> watvap should not be %f\n"
+            message = errmsg % self.args[1]['watvap']
+        if self.args[0] == -4:
+            errmsg = "*** S_spectral2 -> assym should not be %f\n"
+            message = errmsg % self.args[1]['assym']
+        return message

solar_utils/tests/__init__.py

@@ -0,0 +1,5 @@
+"""
+Tests for solar utilities.
+
+2026 Mark Mikofski
+"""

solar_utils/tests/test_cdlls.py

@@ -0,0 +1,225 @@
+#! /usr/bin/env python
+# -*- coding: utf-8 -*-
+"""
+Tests for solar utilities.
+
+Usage
+=====
+This code uses pytest. Enter the following in a CMD shell::
+
+    $ pytest --verbose
+
+2026 Mark Mikofski
+"""
+
+import datetime as pydatetime
+import json
+import numpy as np
+import os
+
+from solar_utils import *
+from solar_utils.exceptions import SOLPOS_Error, SPECTRL2_Error
+
+_DIRNAME = os.path.dirname(__file__)
+TOL = 1E-3
+
+RELDIFF = lambda x, x0: np.abs(x - x0) / x0
+
+
+def test_get_solpos8760():
+    location = [35.56836, -119.2022, -8.0]
+    weather = [1015.62055, 40.0]
+    x, y = get_solpos8760(location, 2017, weather)
+    z = np.array([
+        [ 98.96697  , 248.12735  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 111.86818  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 111.86365  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 111.85951  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 111.85494  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 111.85041  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 111.84623  ,  -1.       ,  -1.       ],
+        [ 91.8338   , 117.05424  ,  64.716125 ,  64.88354  ],
+        [ 81.50037  , 126.166016 ,   6.489029 ,   6.5058155],
+        [ 72.399506 , 136.78699  ,   3.2762375,   3.2847128],
+        [ 65.06621  , 149.33855  ,   2.3618126,   2.3679223],
+        [ 60.21105  , 163.89734  ,   2.0070193,   2.0122113],
+        [ 58.47457  , 179.82529  ,   1.9076174,   1.9125524],
+        [ 60.13257  , 195.77512  ,   2.002265 ,   2.0074446],
+        [ 64.921104 , 210.37862  ,   2.3491564,   2.3552334],
+        [ 72.20489  , 222.98093  ,   3.2422662,   3.2506535],
+        [ 81.272095 , 233.6459   ,   6.333636 ,   6.3500204],
+        [ 91.55735  , 242.79282  ,  64.014565 ,  64.18017  ],
+        [ 98.96697  , 248.20842  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 248.21324  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 248.21808  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 248.22249  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 248.22736  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 248.23221  ,  -1.       ,  -1.       ]],
+        dtype=np.float32)
+    assert np.allclose(x[:24], z[:24,:2], TOL)
+    assert np.allclose(y[:24], z[:24,2:])
+
+
+def test_get_solposAM():
+    location = [35.56836, -119.2022, -8.0]
+    weather = [1015.62055, 40.0]
+    times = [
+        (pydatetime.datetime(2017, 1, 1, 0, 0, 0)
+         + pydatetime.timedelta(hours=h)).timetuple()[:6]
+        for h in range(1000)]
+    x, y = get_solposAM(location, times, weather)
+    z = np.array([
+        [ 98.96697  , 248.12735  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 111.86818  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 111.86365  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 111.85951  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 111.85494  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 111.85041  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 111.84623  ,  -1.       ,  -1.       ],
+        [ 91.8338   , 117.05424  ,  64.716125 ,  64.88354  ],
+        [ 81.50037  , 126.166016 ,   6.489029 ,   6.5058155],
+        [ 72.399506 , 136.78699  ,   3.2762375,   3.2847128],
+        [ 65.06621  , 149.33855  ,   2.3618126,   2.3679223],
+        [ 60.21105  , 163.89734  ,   2.0070193,   2.0122113],
+        [ 58.47457  , 179.82529  ,   1.9076174,   1.9125524],
+        [ 60.13257  , 195.77512  ,   2.002265 ,   2.0074446],
+        [ 64.921104 , 210.37862  ,   2.3491564,   2.3552334],
+        [ 72.20489  , 222.98093  ,   3.2422662,   3.2506535],
+        [ 81.272095 , 233.6459   ,   6.333636 ,   6.3500204],
+        [ 91.55735  , 242.79282  ,  64.014565 ,  64.18017  ],
+        [ 98.96697  , 248.20842  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 248.21324  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 248.21808  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 248.22249  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 248.22736  ,  -1.       ,  -1.       ],
+        [ 98.96697  , 248.23221  ,  -1.       ,  -1.       ]],
+        dtype=np.float32)
+    assert np.allclose(x[:24], z[:24,:2], TOL)
+    assert np.allclose(y[:24], z[:24,2:])
+    # test LOCATION
+    location = [1135.56836, -119.2022, -8.0]
+    try:
+        x, y = get_solposAM(location, times, weather)
+    except SOLPOS_Error as err:
+        assert err.args[0] == 'S_LAT_ERROR'
+    location = [35.56836, -119.2022, -8.0]
+    # test DATETIMES
+    times = [list(ts) for ts in times]
+    times[10][5] = 3248273
+    times = [tuple(ts) for ts in times]
+    try:
+        x, y = get_solposAM(location, times, weather)
+    except SOLPOS_Error as err:
+        assert err.args[0] == 'S_SECOND_ERROR'
+
+
+def test_solposAM():
+    """
+    test solposAM.dll
+    """
+    # test data
+    test_data = {'angles': [15.074043273925781, 213.29042053222656],
+                 'airmass': [1.0352272987365723, 1.0379053354263306]}
+    location = [35.56836, -119.2022, -8.0]
+    datetime = [2013, 6, 5, 12, 31, 0]
+    weather = [1015.62055, 40.0]
+    # call test function
+    angles, airmass = solposAM(location, datetime, weather)
+    # test OUTPUTS are within TOL
+    # FIXME: use np.testing.assert_allclose instead of manual RELDIFF checks
+    assert np.all(RELDIFF(angles[0], test_data['angles'][0]) < TOL)
+    assert np.all(RELDIFF(angles[1], test_data['angles'][1]) < TOL)
+    assert np.all(RELDIFF(airmass[0], test_data['airmass'][0]) < TOL)
+    assert np.all(RELDIFF(airmass[1], test_data['airmass'][1]) < TOL)
+    # test errors - YEAR
+    datetime = [2051, 6, 5, 12, 31, 0]
+    try:
+        solposAM(location, datetime, weather)
+    except SOLPOS_Error as err:
+        assert err.args[0] == 'S_YEAR_ERROR'
+    # test MONTH
+    datetime = [2013, 13, 5, 12, 31, 0]
+    try:
+        solposAM(location, datetime, weather)
+    except SOLPOS_Error as err:
+        assert err.args[0] == 'S_MONTH_ERROR'
+    # test DAY
+    datetime = [2013, 6, 32, 12, 31, 0]
+    try:
+        solposAM(location, datetime, weather)
+    except SOLPOS_Error as err:
+        assert err.args[0] == 'S_DAY_ERROR'
+    # test HOUR
+    datetime = [2013, 6, 5, 25, 31, 0]
+    try:
+        solposAM(location, datetime, weather)
+    except SOLPOS_Error as err:
+        assert err.args[0] == 'S_HOUR_ERROR'
+    # test MINUTE
+    datetime = [2013, 6, 5, 12, 61, 0]
+    try:
+        solposAM(location, datetime, weather)
+    except SOLPOS_Error as err:
+        assert err.args[0] == 'S_MINUTE_ERROR'
+    # test SECOND
+    datetime = [2013, 6, 5, 12, 31, 61]
+    try:
+        solposAM(location, datetime, weather)
+    except SOLPOS_Error as err:
+        assert err.args[0] == 'S_SECOND_ERROR'
+
+
+def test_spectrl2():
+    """
+    test spectrl2.dll
+    """
+    # test data
+    test_data_jsonfile = 'test_spectrl2_data.json'
+    with open(os.path.join(_DIRNAME, test_data_jsonfile), 'r') as filepath:
+        test_data = json.load(filepath)
+    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)
+    # call test function
+    (specdif, specdir, specetr, specglo,
+     specx) = spectrl2(units, location, datetime, weather, orientation,
+                       atmospheric_conditions, albedo)
+    # convert OUTPUT to numpy arrays
+    _specdif = np.ctypeslib.as_array(specdif)  # use ctypeslib
+    _specdir = np.ctypeslib.as_array(specdir)
+    _specetr = np.ctypeslib.as_array(specetr)
+    _specglo = np.ctypeslib.as_array(specglo)
+    _specx = np.ctypeslib.as_array(specx)
+    # test OUTPUT are within TOL
+    # FIXME: use np.testing.assert_allclose instead of manual RELDIFF checks
+    assert np.all(RELDIFF(_specdif, test_data['specdif']) < TOL)
+    assert np.all(RELDIFF(_specdir, test_data['specdir']) < TOL)
+    assert np.all(RELDIFF(_specetr, test_data['specetr']) < TOL)
+    assert np.all(RELDIFF(_specglo, test_data['specglo']) < TOL)
+    assert np.all(RELDIFF(_specx, test_data['specx']) < TOL)
+    # raise a SPECTRL2_Error - UNITS
+    try:
+        spectrl2(3, location, datetime, weather, orientation,
+                 atmospheric_conditions, albedo)
+    except SPECTRL2_Error as err:
+        assert err.args[0] == -1
+    # raise a SPECTRL2_Error - TAU500
+    try:
+        spectrl2(units, location, datetime, weather, orientation,
+                 [-1.0] * 5, albedo)
+    except SPECTRL2_Error as err:
+        assert err.args[0] == -2
+    # now raise a SOLPOS_Error - YEAR
+    datetime = [2051, 6, 5, 12, 31, 0]
+    try:
+        spectrl2(units, location, datetime, weather, orientation,
+                 atmospheric_conditions, albedo)
+    except SOLPOS_Error as err:
+        assert err.args[0] == 'S_YEAR_ERROR'
+
+if __name__ == '__main__':
+    test_spectrl2()

solar_utils/tests/test_spectrl2_data.json

@@ -0,0 +1,154 @@
+{
+ "specdif": [
+  1.8256434202194214, 17.148418426513672, 46.67808532714844, 92.94384765625,
+  121.91969299316406, 170.91250610351562, 217.76622009277344,
+  219.23980712890625, 215.29632568359375, 219.9678955078125,
+  236.76014709472656, 237.5330810546875, 272.32635498046875, 267.9977722167969,
+  250.46548461914062, 357.3795166015625, 409.7325134277344, 417.58392333984375,
+  379.23907470703125, 436.9317626953125, 473.8831481933594, 471.4217529296875,
+  447.6335144042969, 445.4048156738281, 405.9974670410156, 398.010498046875,
+  391.03826904296875, 362.05389404296875, 363.166015625, 354.62506103515625,
+  344.33380126953125, 315.5977783203125, 282.89276123046875, 273.4025573730469,
+  256.17169189453125, 227.1124267578125, 224.96456909179688, 185.011962890625,
+  192.93472290039062, 162.24752807617188, 155.99087524414062,
+  168.61582946777344, 164.92115783691406, 160.66506958007812,
+  94.19819641113281, 133.77293395996094, 147.88609313964844,
+  137.38803100585938, 112.47001647949219, 104.15765380859375,
+  111.84978485107422, 112.81221008300781, 111.17762756347656,
+  102.47245788574219, 68.63471221923828, 69.3549575805664, 65.4437255859375,
+  44.521202087402344, 32.40762710571289, 33.900672912597656, 59.41389846801758,
+  64.13468170166016, 69.25424194335938, 61.30603790283203, 55.20729064941406,
+  41.383174896240234, 12.391764640808105, 16.226001739501953,
+  15.225900650024414, 29.422449111938477, 32.120059967041016,
+  32.47023010253906, 33.25129699707031, 27.744041442871094, 29.106645584106445,
+  22.566112518310547, 4.330706596374512, 0.3838190734386444, 3.492144823074341,
+  6.2399139404296875, 6.015700340270996, 11.793516159057617,
+  16.401538848876953, 15.6276273727417, 14.255119323730469, 13.917386054992676,
+  12.989603996276855, 12.33969783782959, 13.073138236999512,
+  12.412393569946289, 11.351621627807617, 8.5829439163208, 2.005711555480957,
+  0.1156865805387497, 0.35932114720344543, 1.0042234659194946,
+  3.953986167907715, 1.2784755229949951, 3.875173807144165, 3.0610997676849365,
+  3.453407049179077, 3.166436195373535, 2.7821335792541504, 2.4278974533081055,
+  1.881614089012146, 0.5927937030792236, 0.1878427267074585,
+  4.3069093180747586e-08, 6.464413726536833e-11, 2.3338509436143795e-07,
+  0.03232985734939575, 0.1072206050157547, 0.0981285348534584,
+  0.1371127963066101, 0.09519591182470322, 0.19665323197841644,
+  0.28267475962638855, 0.26244720816612244, 0.23989030718803406,
+  0.22150859236717224, 0.19426670670509338, 0.1939333975315094
+ ],
+ "specdir": [
+  0.9149357080459595, 9.68359375, 29.28199005126953, 63.89971160888672,
+  91.44681549072266, 138.75453186035156, 190.586181640625, 206.19862365722656,
+  216.7138214111328, 235.91452026367188, 269.44183349609375, 301.0520324707031,
+  379.4623718261719, 406.0775146484375, 408.90765380859375, 623.77392578125,
+  759.52734375, 817.4668579101562, 780.1897583007812, 940.6309814453125,
+  1063.818603515625, 1119.2725830078125, 1120.5660400390625,
+  1172.5084228515625, 1121.2725830078125, 1150.788818359375,
+  1181.3558349609375, 1140.5875244140625, 1191.60107421875, 1209.749755859375,
+  1219.31884765625, 1200.78857421875, 1164.79541015625, 1178.989990234375,
+  1166.7801513671875, 1106.51708984375, 1127.48681640625, 996.6547241210938,
+  1067.58740234375, 941.46630859375, 923.0817260742188, 998.2432250976562,
+  997.566650390625, 981.5950927734375, 639.4552001953125, 857.7056884765625,
+  944.158203125, 913.6908569335938, 790.43212890625, 747.81689453125,
+  797.17138671875, 809.8842163085938, 819.34130859375, 780.630615234375,
+  577.6444091796875, 587.2220458984375, 562.51220703125, 409.9044189453125,
+  312.8055114746094, 328.8128662109375, 538.27587890625, 582.6295166015625,
+  627.5308837890625, 587.275390625, 549.2069091796875, 443.9672546386719,
+  157.4540557861328, 202.82371520996094, 194.2506866455078, 348.53863525390625,
+  376.73052978515625, 386.14031982421875, 403.5086975097656, 352.179443359375,
+  371.6019592285156, 306.12567138671875, 71.12310791015625, 6.875940322875977,
+  61.84910583496094, 107.49081420898438, 104.7576675415039, 191.7346649169922,
+  254.77392578125, 245.11929321289062, 229.71128845214844, 226.039794921875,
+  213.5852813720703, 206.62855529785156, 219.04933166503906, 210.5574951171875,
+  197.1224365234375, 158.13107299804688, 44.59239959716797, 2.8388142585754395,
+  9.00092887878418, 24.810455322265625, 87.16841125488281, 31.691259384155273,
+  85.90641784667969, 70.16461944580078, 78.18312072753906, 72.8062973022461,
+  65.62701416015625, 59.399967193603516, 49.05033493041992, 17.618515014648438,
+  5.997376441955566, 1.4635077150160214e-06, 2.269817223066184e-09,
+  8.451898793282453e-06, 1.195347785949707, 3.9817092418670654,
+  3.737084150314331, 5.256494045257568, 3.7773163318634033, 7.605112552642822,
+  10.660894393920898, 10.066052436828613, 9.372171401977539, 8.79566764831543,
+  7.892968654632568, 7.920684814453125
+ ],
+ "specetr": [
+  518.744873046875, 540.4277954101562, 602.0886840820312, 670.5254516601562,
+  692.2083129882812, 806.2373657226562, 931.1078491210938, 902.0682373046875,
+  871.7701416015625, 882.1276245117188, 944.2724609375, 944.6597290039062,
+  1084.050048828125, 1068.4654541015625, 1000.7062377929688,
+  1431.7513427734375, 1646.83837890625, 1684.6866455078125, 1536.390869140625,
+  1778.1943359375, 1940.8162841796875, 1977.599853515625, 1923.392578125,
+  1962.112060546875, 1835.3056640625, 1847.889404296875, 1865.313232421875,
+  1772.3863525390625, 1830.4656982421875, 1837.2415771484375,
+  1831.4337158203125, 1781.0982666015625, 1711.403076171875, 1672.68359375,
+  1604.9244384765625, 1475.2139892578125, 1481.9898681640625,
+  1374.543212890625, 1354.2154541015625, 1330.0157470703125,
+  1329.0477294921875, 1256.44873046875, 1228.3770751953125, 1205.145263671875,
+  1183.849609375, 1166.42578125, 1145.1300048828125, 1111.25048828125,
+  1056.0750732421875, 1028.00341796875, 1004.771728515625, 989.283935546875,
+  966.7297973632812, 916.87841796875, 864.6070556640625, 840.4073486328125,
+  803.1398315429688, 803.7205810546875, 787.9423828125, 761.7099609375,
+  743.705322265625, 742.4469604492188, 733.3478393554688, 666.0726318359375,
+  620.1900634765625, 586.79443359375, 567.144287109375, 551.9468994140625,
+  546.0421142578125, 526.7791748046875, 516.324951171875, 485.5428771972656,
+  462.21435546875, 428.52838134765625, 425.914794921875, 403.45745849609375,
+  378.8705749511719, 347.41094970703125, 317.0161437988281, 307.33624267578125,
+  297.4627685546875, 290.7836608886719, 283.42694091796875, 266.6807556152344,
+  263.38958740234375, 250.99932861328125, 238.99627685546875,
+  236.18911743164062, 235.7051239013672, 227.28363037109375,
+  213.44139099121094, 184.69215393066406, 165.62278747558594,
+  139.87429809570312, 131.35598754882812, 119.06254577636719,
+  119.83694458007812, 109.3826675415039, 105.02671813964844, 94.37884521484375,
+  89.44210815429688, 79.7622299194336, 72.2119140625, 66.11359405517578,
+  61.75764465332031, 47.9154167175293, 46.947425842285156, 37.364341735839844,
+  35.428367614746094, 30.975622177124023, 27.200468063354492,
+  24.006107330322266, 21.392539978027344, 18.97256851196289, 16.93979263305664,
+  15.19741439819336, 13.64863395690918, 12.293449401855469, 11.131864547729492,
+  10.067076683044434, 9.195887565612793, 8.324698448181152
+ ],
+ "specglo": [
+  2.6605875492095947, 25.985387802124023, 73.39999389648438,
+  151.25689697265625, 205.37142944335938, 297.5359191894531, 391.689697265625,
+  407.4107666015625, 413.0631408691406, 435.2567138671875, 482.64501953125,
+  512.2645263671875, 618.61279296875, 638.5724487304688, 623.6228637695312,
+  926.61767578125, 1102.8553466796875, 1163.580810546875, 1091.2178955078125,
+  1295.3245849609375, 1444.6934814453125, 1492.837890625, 1470.22998046875,
+  1515.40234375, 1429.2386474609375, 1448.1873779296875, 1469.109619140625,
+  1402.92138671875, 1450.5869140625, 1458.60791015625, 1457.04931640625,
+  1411.4029541015625, 1345.8515625, 1349.3150634765625, 1320.94189453125,
+  1236.88818359375, 1253.876708984375, 1094.530517578125, 1167.184326171875,
+  1021.4027099609375, 998.3687744140625, 1079.583984375, 1075.2718505859375,
+  1056.4405517578125, 677.7466430664062, 916.4905395507812, 1009.497802734375,
+  971.196044921875, 833.7957153320312, 786.5938720703125, 839.3255004882812,
+  851.8892822265625, 858.885009765625, 814.8535766601562, 595.7764282226562,
+  605.2369995117188, 578.7762451171875, 418.5882263183594, 317.8649597167969,
+  333.9658508300781, 550.6290283203125, 595.82568359375, 641.9208984375,
+  597.2366943359375, 556.3977661132812, 446.53497314453125, 156.07981872558594,
+  201.31710815429688, 192.49351501464844, 347.4888000488281, 375.9135437011719,
+  384.850830078125, 401.48175048828125, 349.1329040527344, 368.2199401855469,
+  301.9276123046875, 69.23561096191406, 6.658605098724365, 59.93386459350586,
+  104.33294677734375, 101.61454010009766, 186.76507568359375,
+  248.90090942382812, 239.3164520263672, 223.883056640625, 220.19482421875,
+  207.9014129638672, 200.90298461914062, 212.9712677001953, 204.56112670898438,
+  191.23989868164062, 152.88882446289062, 42.69945526123047,
+  2.7063071727752686, 8.573310852050781, 23.645532608032227, 83.50138092041016,
+  30.19900894165039, 82.27090454101562, 67.09131622314453, 74.80107879638672,
+  69.60737609863281, 62.67146682739258, 56.634605407714844, 46.6435432434082,
+  16.67094612121582, 5.660876750946045, 1.3786242334390408e-06,
+  2.1360142543613847e-09, 7.946346158860251e-06, 1.1231698989868164,
+  3.740814208984375, 3.508484363555908, 4.934038162231445, 3.542266607284546,
+  7.1368608474731445, 10.01150131225586, 9.448437690734863, 8.792664527893066,
+  8.248183250427246, 7.397163391113281, 7.422123432159424
+ ],
+ "specx": [
+  0.3, 0.305, 0.31, 0.315, 0.32, 0.325, 0.33, 0.335, 0.34, 0.345, 0.35, 0.36,
+  0.37, 0.38, 0.39, 0.4, 0.41, 0.42, 0.43, 0.44, 0.45, 0.46, 0.47, 0.48, 0.49,
+  0.5, 0.51, 0.52, 0.53, 0.54, 0.55, 0.57, 0.593, 0.61, 0.63, 0.656, 0.6676,
+  0.69, 0.71, 0.718, 0.7244, 0.74, 0.7525, 0.7575, 0.7625, 0.7675, 0.78, 0.8,
+  0.816, 0.8237, 0.8315, 0.84, 0.86, 0.88, 0.905, 0.915, 0.925, 0.93, 0.937,
+  0.948, 0.965, 0.98, 0.9935, 1.04, 1.07, 1.1, 1.12, 1.13, 1.145, 1.161, 1.17,
+  1.2, 1.24, 1.27, 1.29, 1.32, 1.35, 1.395, 1.4425, 1.4625, 1.477, 1.497, 1.52,
+  1.539, 1.558, 1.578, 1.592, 1.61, 1.63, 1.646, 1.678, 1.74, 1.8, 1.86, 1.92,
+  1.96, 1.985, 2.005, 2.035, 2.065, 2.1, 2.148, 2.198, 2.27, 2.36, 2.45, 2.5,
+  2.6, 2.7, 2.8, 2.9, 3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 3.6, 3.7, 3.8, 3.9, 4.0
+ ]
+}

solarutils-0.4.8.dist-info/METADATA

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: SolarUtils
+Version: 0.4.8
+Summary: Python wrappers around NREL SOLPOS and SPECTRL2
+Home-page: https://github.com/mikofski/SolarUtils
+Author: Mark Mikofski
+Author-email: bwana.marko@yahoo.com
+License: BSD 3-Clause
+Platform: win32
+Platform: linux
+Platform: linux2
+Platform: darwin
+License-File: LICENSE
+Provides-Extra: test
+Requires-Dist: numpy; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: platform
+Dynamic: provides-extra
+Dynamic: summary
+
+.. image:: https://github.com/mikofski/SolarUtils/actions/workflows/python-test.yml/badge.svg
+    :target: https://github.com/mikofski/SolarUtils/actions/workflows/python-test.yml
+
+SolarUtils is set of Python wrappers around the publicly available
+`NREL <http://www.nrel.gov/>`_
+`SOLPOS <http://rredc.nrel.gov/solar/codesandalgorithms/solpos/>`_ and
+`SPECTRL2 <http://rredc.nrel.gov/solar/models/spectral/>`_ C-language computer
+programs that calculate solar position and spectral decomposition. Please read
+the `NREL disclaimer and license <http://www.nrel.gov/disclaimer.html>`_. Usage
+of this software implies acceptance of the terms.
+
+Installation
+============
+Use ``pip`` to install
+`SolarUtils from the PyPI <https://pypi.python.org/pypi/SolarUtils>`_::
+
+    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 <http://rredc.nrel.gov/solar/codesandalgorithms/solpos/aboutsolpos.html>`_
+and
+`SPECTRL2 Documentation <http://rredc.nrel.gov/solar/models/spectral/spectrl2/documentation.html>`_
+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()

solarutils-0.4.8.dist-info/RECORD

@@ -0,0 +1,15 @@
+solar_utils/NREL_DISCLAIMERS-COPYRIGHTS-LICENSES.txt,sha256=rcnn4G5mGQiwmH7STxDT2VI1-fh2pWRIIevQ5uVyyWk,3809
+solar_utils/__init__.py,sha256=iHQv1h-D2EcVcqRy7kaI1LzIzfQli7eIpl5EYuAPebY,416
+solar_utils/core.py,sha256=-uLbqDV2kO1MmFBG2sid6yYlXle2ePxvQA8SeZCDWHM,11194
+solar_utils/dummy.cp313-win_amd64.pyd,sha256=FENvOPplo7gHqu6dyaZyVIX8k-gH5Ev0Y0jTO6-Dy_Y,9728
+solar_utils/exceptions.py,sha256=CFeUqtGwwVBmo4nukXPP7q24K1wB3wvKktmYpnTd_lc,5030
+solar_utils/solposAM.dll,sha256=2hteBib54dYHt9LuYLefbkl8vqAjXjM6_KvxcG27vHQ,14336
+solar_utils/spectrl2.dll,sha256=fypZPEUM0ke_u67ckAxC8Vi38VW4PR-dewF_W0BDpx8,23040
+solar_utils/tests/__init__.py,sha256=Asix3OCHzqoO8GSk3RKAUsbpJ2Xif-hDbjAhkQaIjGQ,60
+solar_utils/tests/test_cdlls.py,sha256=zEtxphIh5gceq7BjN703IIkRv1YEfoh7HDzYoHROGfU,9034
+solar_utils/tests/test_spectrl2_data.json,sha256=BL74L0iSmTKP-JDhhY1-g0fHfWv2J6Izrv5LUexsIQE,10637
+solarutils-0.4.8.dist-info/licenses/LICENSE,sha256=WH-S__LyaIxxN7nDu2h9dacDe2DBhDAq_avzcfFtn2k,1518
+solarutils-0.4.8.dist-info/METADATA,sha256=CLWrOlamql_mBkjNci-CgrOn7jOaJwB0aT6LFKOX9xY,3410
+solarutils-0.4.8.dist-info/WHEEL,sha256=fOyJWI5N6P4iPL9_doBC3lf0L4Z-hcIkjNV5ilMSlqY,101
+solarutils-0.4.8.dist-info/top_level.txt,sha256=z2p3nYQUAh05vyKeJYRmCvw25A1l7kJw57DP7QBoDZw,12
+solarutils-0.4.8.dist-info/RECORD,,

solarutils-0.4.8.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: false
+Tag: cp313-cp313-win_amd64
+

solarutils-0.4.8.dist-info/licenses/LICENSE

@@ -0,0 +1,28 @@
+Copyright (c) 2026, Mark Mikofski Corp.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice,
+this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation
+and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+may be used to endorse or promote products derived from this software without
+specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

solarutils-0.4.8.dist-info/top_level.txt

@@ -0,0 +1 @@
+solar_utils