SolarUtils 0.2.4__tar.gz → 0.4.8__tar.gz

{SolarUtils-0.2.4 → solarutils-0.4.8}/CHANGES.rst

@@ -1,6 +1,24 @@
 Changes
 =======
 
+For more recent changes, please see
+`GitHub Releases <https://github.com/mikofski/SolarUtils/releases>`_.
+
+v0.4.8 - Dentists (2026-10-22)
+------------------------------
+* use pytest
+* publish to PyPI
+* publish docs
+
+v0.4 - Doctors (2026-10-08)
+---------------------------
+* apply conda-forge patches
+* create github actions
+
+v0.3 - Carpenters (2019-05-22)
+------------------------------
+* adds ``get_solposAM`` and ``get_solpos8760``
+
 v0.2.1 - Bartenders (2016-07-11)
 --------------------------------
 * add documentation

{SolarUtils-0.2.4 → solarutils-0.4.8}/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2016, SunPower Corp.
+Copyright (c) 2026, Mark Mikofski Corp.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

solarutils-0.4.8/PKG-INFO

@@ -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.2.4 → solarutils-0.4.8}/README.rst

@@ -1,5 +1,5 @@
-.. image:: https://travis-ci.org/SunPower/SolarUtils.svg?branch=master
-    :target: https://travis-ci.org/SunPower/SolarUtils
+.. 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/>`_

solarutils-0.4.8/SolarUtils.egg-info/PKG-INFO

@@ -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.2.4 → solarutils-0.4.8}/SolarUtils.egg-info/SOURCES.txt

@@ -15,11 +15,7 @@ solar_utils/core.py
 solar_utils/darwin.mk
 solar_utils/dummy.c
 solar_utils/exceptions.py
-solar_utils/libsolposAM.so
-solar_utils/libspectrl2.so
 solar_utils/linux.mk
-solar_utils/solposAM.dll
-solar_utils/spectrl2.dll
 solar_utils/win32.mk
 solar_utils/docs/Makefile
 solar_utils/docs/conf.py

solarutils-0.4.8/SolarUtils.egg-info/requires.txt

@@ -0,0 +1,4 @@
+
+[test]
+numpy
+pytest

{SolarUtils-0.2.4 → solarutils-0.4.8}/setup.cfg

@@ -1,4 +1,4 @@
-[pytest]
+[tool:pytest]
 norecursedirs = .git build dist venv
 
 [egg_info]

{SolarUtils-0.2.4 → solarutils-0.4.8}/setup.py

@@ -1,14 +1,14 @@
 """
 SolarUtils Package Setup
-Copyright (c) 2016 SunPower Corp.
-Confidential & Proprietary
-Do Not Distribute
+Copyright (c) 2026 Mark Mikofski
+forked from SunPower/SolarUtils
 """
 
 import sys
 import os
 import shutil
 from distutils import unixccompiler
+from distutils.sysconfig import customize_compiler
 try:
     from setuptools import setup, distutils, Extension
 except ImportError:
@@ -42,7 +42,8 @@ elif PLATFORM == 'darwin':
     LIB_FILE = 'lib%s.dylib'
     RPATH = "-Wl,-rpath,@loader_path/"
     INSTALL_NAME = "@rpath/" + LIB_FILE
-    CCFLAGS = LDFLAGS = ['-fPIC']
+    CCFLAGS = ['-fPIC']
+    LDFLAGS = ['-fPIC', '-dynamiclib']
 elif PLATFORM in ['linux', 'linux2']:
     PLATFORM = 'linux'
     LIB_FILE = 'lib%s.so'
@@ -148,6 +149,16 @@ elif not LIB_FILES_EXIST:
         CC = OSXCCOMPILER(verbose=3)
     else:
         CC = distutils.ccompiler.new_compiler()  # initialize compiler object
+    customize_compiler(CC)
+    # this must come after customize_compiler(CC)
+    if PLATFORM == 'darwin':
+        # on mac osx remove '-bundle' & '-shared' from linker flags
+        # so it doesn't clash with -dynamiclib & -install_name
+        CC.set_executables(
+            linker_so=[
+                flag for flag in CC.linker_so
+                if flag not in ('-bundle', '-shared')
+            ])
     CC.add_include_dir(SRC_DIR)  # set includes directory
     # compile solpos and solposAM objects into build directory
     OBJS = CC.compile([SOLPOS, SOLPOSAM], output_dir=BUILD_DIR,
@@ -173,7 +184,7 @@ if LIB_FILES_EXIST and 'sdist' not in sys.argv:
     PKG_DATA += [SOLPOSAM_LIB_FILE, SPECTRL2_LIB_FILE]
 
 # Tests will require these packages
-test_requires = ['numpy', 'nose']
+test_requires = ['numpy', 'pytest']
 
 setup(
     name='SolarUtils',
@@ -188,5 +199,5 @@ setup(
     packages=[NAME, TESTS],
     package_data={NAME: PKG_DATA, TESTS: TEST_DATA},
     ext_modules=[DUMMY],
-    extras_require={'testing': test_requires}
+    extras_require={'test': test_requires}
 )

solarutils-0.4.8/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']

{SolarUtils-0.2.4 → solarutils-0.4.8}/solar_utils/core.py

@@ -6,10 +6,11 @@ Solar utilities based on `SOLPOS
 `NREL RREDC Solar Resource Models and Tools
 <http://www.nrel.gov/rredc/models_tools.html>`_
 
-2013 SunPower Corp.
+2026 Mark Mikofski
 """
 
 import ctypes
+import datetime as pydatetime
 import math
 import os
 import sys
@@ -43,6 +44,95 @@ def _int2bits(err_code):
     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
@@ -111,7 +201,7 @@ def spectrl2(units, location, datetime, weather, orientation,
     Calculate solar spectrum by calling functions exported by
     :data:`SPECTRL2DLL`.
 
-    :param units: set ``units`` = 1 for W/m\ :sup:`2`/micron
+    :param units: set ``units`` = 1 for W/m:sup:`2`/micron
     :type units: int
     :param location: latitude, longitude and UTC-timezone
     :type location: float

{SolarUtils-0.2.4 → solarutils-0.4.8}/solar_utils/docs/conf.py

@@ -12,9 +12,13 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 
+from __future__ import unicode_literals, absolute_import, division
 import sys
 import os
 
+if sys.version_info[0] >= 3:
+    unicode = str
+
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
@@ -53,7 +57,7 @@ master_doc = 'index'
 
 # General information about the project.
 project = u'SolarUtils'
-copyright = u'2016, SunPower'
+copyright = u'2026, Mark Mikofski'
 author = unicode(__author__)
 
 # The version info for the project you're documenting, acts as replacement for
@@ -70,7 +74,7 @@ release = unicode(__release__)
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = 'en'
 
 # There are two options for replacing |today|: either, you set today to some
 # non-false value, then it is used:
@@ -120,7 +124,7 @@ html_theme = 'alabaster'
 # further.  For a list of options available for each theme, see the
 # documentation.
 html_theme_options = {
-    'github_user': 'SunPower',
+    'github_user': 'mikofski',
     'github_repo': 'SolarUtils',
     'github_banner': True,
     'show_related': True
@@ -296,4 +300,4 @@ texinfo_documents = [
 
 
 # Example configuration for intersphinx: refer to the Python standard library.
-intersphinx_mapping = {'https://docs.python.org/2': None}
+intersphinx_mapping = {'python': ('https://docs.python.org/3/', None),}

{SolarUtils-0.2.4 → solarutils-0.4.8}/solar_utils/docs/core.rst

@@ -30,6 +30,14 @@ that imports :data:`SOLPOSAMDLL` and exports functions called by
 
 .. data:: SPECTRL2DLL
 
+get_solpos8760
+--------------
+.. autofunction:: get_solpos8760
+
+get_solposAM
+------------
+.. autofunction:: get_solposAM
+
 solposAM
 --------
 .. autofunction:: solposAM

{SolarUtils-0.2.4 → solarutils-0.4.8}/solar_utils/exceptions.py

@@ -2,7 +2,7 @@
 """
 Exceptions for solar utilities.
 
-2013 SunPower Corp.
+2026 Mark Mikofski
 """