[v0.0.6] 2025-08-27

🚨++ New Plug-in Integrated ++ 🚨
- Solar Position plug-in integrated with PyHelios

## Bug Fixes
- Fixed plugin registry detection for selective builds (`--plugins visualizer`)
- Fixed SolarPosition plugin metadata to correctly reflect optional status
- Fixed WeberPennTree constructor to properly handle unavailable plugin scenarios
- Updated error messages for plugin availability to match build configurations

## Testing
- Enhanced cross-platform tests for selective plugin builds
- Fixed test failures when building with limited plugin sets
- Improved error handling validation in plugin availability tests

Author: bnbailey-psl

.gitignore

@@ -9,6 +9,9 @@ build/
 *.egg-info/
 *.egg
 
+# Auto-generated version file (setuptools-scm)
+pyhelios/_version.py
+
 # IDEs and editors
 .vscode/
 .idea/

build_scripts/build_helios.py

@@ -1406,12 +1406,13 @@ def get_default_plugins() -> List[str]:
     - weberpenntree: Procedural tree generation
     - radiation: OptiX-accelerated ray tracing (GPU optional)
     - energybalance: GPU-accelerated thermal modeling and energy balance
+    - solarposition: Solar position calculations and sun angle modeling
     
     Returns:
         List of default plugins
     """
     # Return the plugins that are actually integrated into PyHelios
-    integrated_plugins = ["visualizer", "weberpenntree", "radiation", "energybalance"]
+    integrated_plugins = ["visualizer", "weberpenntree", "radiation", "energybalance", "solarposition"]
 
     # Filter by platform compatibility
     default_plugins = []

docs/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+# [v0.0.6] 2025-08-27
+
+🚨++ New Plug-in Integrated ++ 🚨
+- Solar Position plug-in integrated with PyHelios
+
+## Bug Fixes
+- Fixed plugin registry detection for selective builds (`--plugins visualizer`)
+- Fixed SolarPosition plugin metadata to correctly reflect optional status
+- Fixed WeberPennTree constructor to properly handle unavailable plugin scenarios
+- Updated error messages for plugin availability to match build configurations
+
+## Testing
+- Enhanced cross-platform tests for selective plugin builds
+- Fixed test failures when building with limited plugin sets
+- Improved error handling validation in plugin availability tests
+
 # [v0.0.5] 2025-08-27
 
 - Helios native C++ had several bugs that was causing errors in the last version. Merged in patched version of 1.3.46.

docs/Doxyfile.python

@@ -131,6 +131,7 @@ INPUT                  = pyhelios \
                          docs/plugin_integration_guide.md \
                          docs/plugin_energybalance.md \
                          docs/plugin_radiation.md \
+                         docs/plugin_solarposition.md \
                          docs/plugin_visualizer.md \
                          docs/plugin_weberpenntree.md \
                          docs/CHANGELOG.md \
@@ -148,6 +149,7 @@ EXCLUDE                = pyhelios/plugins/__pycache__ \
                          pyhelios/wrappers/ULoggerWrapper.py \
                          pyhelios/wrappers/URadiationModelWrapper.py \
                          pyhelios/wrappers/UEnergyBalanceWrapper.py \
+                         pyhelios/wrappers/USolarPositionWrapper.py \
                          pyhelios/wrappers/UVisualizerWrapper.py \
                          pyhelios/wrappers/UWeberPennTreeWrapper.py \
                          pyhelios/config \

docs/DoxygenLayout.xml

@@ -25,6 +25,7 @@
       <!-- Currently Implemented Plugins (Alphabetized) -->
       <tab type="user" visible="yes" url="@ref EnergyBalanceDoc" title="Energy Balance Model"/>
       <tab type="user" visible="yes" url="@ref RadiationDoc" title="Radiation Model"/>
+      <tab type="user" visible="yes" url="@ref SolarPositionDoc" title="Solar Position"/>
       <tab type="user" visible="yes" url="@ref VisualizerDoc" title="Visualizer"/>
       <tab type="user" visible="yes" url="@ref WeberPennTreeDoc" title="Weber-Penn Tree"/>
     </tab>

native/include/pyhelios_wrapper_context.h

@@ -766,6 +766,58 @@ PYHELIOS_API void colorPrimitiveByDataPseudocolor(helios::Context* context, unsi
  */
 PYHELIOS_API void colorPrimitiveByDataPseudocolorWithRange(helios::Context* context, unsigned int* uuids, size_t num_uuids, const char* primitive_data, const char* colormap, unsigned int ncolors, float data_min, float data_max);
 
+/**
+ * @brief Set the simulation time using hour and minute
+ * @param context Pointer to the Context
+ * @param hour Hour (0-23)
+ * @param minute Minute (0-59)
+ */
+PYHELIOS_API void setTime_HourMinute(helios::Context* context, int hour, int minute);
+
+/**
+ * @brief Set the simulation time using hour, minute, and second
+ * @param context Pointer to the Context
+ * @param hour Hour (0-23)
+ * @param minute Minute (0-59)
+ * @param second Second (0-59)
+ */
+PYHELIOS_API void setTime_HourMinuteSecond(helios::Context* context, int hour, int minute, int second);
+
+/**
+ * @brief Set the simulation date using day, month, and year
+ * @param context Pointer to the Context
+ * @param day Day (1-31)
+ * @param month Month (1-12)
+ * @param year Year (1900-3000)
+ */
+PYHELIOS_API void setDate_DayMonthYear(helios::Context* context, int day, int month, int year);
+
+/**
+ * @brief Set the simulation date using Julian day and year
+ * @param context Pointer to the Context
+ * @param julian_day Julian day (1-366)
+ * @param year Year (1900-3000)
+ */
+PYHELIOS_API void setDate_JulianDay(helios::Context* context, int julian_day, int year);
+
+/**
+ * @brief Get the current simulation time
+ * @param context Pointer to the Context
+ * @param hour Output parameter for hour
+ * @param minute Output parameter for minute
+ * @param second Output parameter for second
+ */
+PYHELIOS_API void getTime(helios::Context* context, int* hour, int* minute, int* second);
+
+/**
+ * @brief Get the current simulation date
+ * @param context Pointer to the Context
+ * @param day Output parameter for day
+ * @param month Output parameter for month
+ * @param year Output parameter for year
+ */
+PYHELIOS_API void getDate(helios::Context* context, int* day, int* month, int* year);
+
 #ifdef __cplusplus
 }
 #endif