[1.3.25] 2025-01-03

*Updated copyright dates to 2025*

*Plant Architecture*
!!! Many significant changes in this release !!!
- The way leaf prototypes are generated has changed. There is now a modifiable parameter set that controls procedural leaf generation (or loading a model from an OBJ file).
- Changed generic leaf prototype function to be able to represent leaf "buckling", such as what happens to long leaves of grasses like maize.
- Removed shoot parameter 'leaf_flush_count'.
- Added shoot parameter 'max_nodes_per_season' to allow the shoot to stop growing for the season, but continue adding nodes in future seasons.
- Phenological thresholds for plants have been changed to be realistic (e.g., the phenological cycle for perennial plants corresponds to days in a year).
- A maximum age limit for plants has been added so users don't inadvertantly specify a very old plant that will cause the program to hang.
- Changed the way that vegetative bud break probability is handled such that it can vary along the shoot. The relevant parameters are now 'vegetative_bud_break_probability_min' and 'vegetative_bud_break_probability_decay_rate'.
- Changed the way that downstream leaf area is calculated to improve computational efficiency. This required some changes in the 'girth_area_factor` parameter.
- Committed all Blender project files used to create organ OBJ models: plugins/plantarchitecture/assets/Blender_organ_models/
- Moved initial internode radius from being a shoot parameter to a phytomer parameter, since it is constant along the shoot and over time.
- Added overloaded PlantArchitecture::advanceTime() method that allows to specify the time step in years and days for advancing over long time periods.
- Changed the name of the shoot parameter 'phyllochron' to 'phyllochron_min' to be consistent with how it will be used in the carbohydrate model.
- Added actual self-test that builds all plants in the library.

*Visualizer*
- Problem fixed in freetype zconf.h file that caused build errors on latest MacOS compilers.
- All output messages were not being properly suppressed after calling disableOutputMessages().

*Canopy Generator*
- Many edits made regarding how parameters with random variation are handled, mainly to ensure proper constraints on values (e.g., always positive).

Author: bnbailey-psl

core/include/Context.h

@@ -1,6 +1,6 @@
 /** \file "Context.h" Context header file.
  
- Copyright (C) 2016-2024 Brian Bailey
+ Copyright (C) 2016-2025 Brian Bailey
  
  This program is free software: you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by

core/include/global.h

@@ -1,6 +1,6 @@
 /** \file "global.h" Header file for all global function/object definitions.
 
-    Copyright (C) 2016-2024 Brian Bailey
+    Copyright (C) 2016-2025 Brian Bailey
 
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
@@ -26,6 +26,8 @@
 #define M_PI 3.14159265358979323846
 #endif
 
+inline constexpr float PI_F = 3.14159265358979323846f;
+
 #ifndef HELIOS_GLOBAL
 #define HELIOS_GLOBAL
 

core/include/helios_vector_types.h

@@ -1,6 +1,6 @@
 /** \file "helios_vector_types.h" Declarations for vector types
 
-    Copyright (C) 2016-2024 Brian Bailey
+    Copyright (C) 2016-2025 Brian Bailey
 
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
@@ -1534,8 +1534,8 @@ inline bool Time::operator!=( const Time &c ) const{
 struct SphericalCoord{
 private:
 
-    float elevation_private;
-    float zenith_private;
+  float elevation_private;
+  float zenith_private;
 
 public:
 
@@ -1556,20 +1556,20 @@ struct SphericalCoord{
 
   //! Default constructor 
   /** initializes to vertical unit vector */
-  SphericalCoord() : elevation_private(0.5*float(M_PI)), elevation(elevation_private), zenith_private(0.f), zenith(zenith_private)   {
+  SphericalCoord() : elevation_private(0.5f*float(M_PI)), zenith_private(0.f), elevation(elevation_private), zenith(zenith_private)   {
     radius=1;
     azimuth=0;
   }
   //! Initialize SphericalCoord by specifying radius, elevation, and azimuth
   /**
    * \param[in] radius Radius
-   * \param[in] elevation Elevation angle (radians)
-   * \param[in] azimuth Azimuthal angle (radians)
+   * \param[in] elevation_radians Elevation angle (radians)
+   * \param[in] azimuth_radians Azimuthal angle (radians)
   */
-  SphericalCoord(float radius, float elevation_radians, float azimuth_radians ) : elevation_private(elevation_radians), elevation(elevation_private), zenith_private(0.5f * float(M_PI) - elevation_radians), zenith(zenith_private), radius(radius), azimuth(azimuth_radians) {}
+  SphericalCoord(float radius, float elevation_radians, float azimuth_radians ) : elevation_private(elevation_radians), zenith_private(0.5f * float(M_PI) - elevation_radians), radius(radius), elevation(elevation_private), zenith(zenith_private), azimuth(azimuth_radians) {}
 
   //! Copy constructor
-  SphericalCoord( const SphericalCoord &c ) : elevation_private(c.elevation_private), elevation(elevation_private), zenith_private(c.zenith_private), zenith(zenith_private), radius(c.radius), azimuth(c.azimuth) {}
+  SphericalCoord( const SphericalCoord &c ) : elevation_private(c.elevation_private), zenith_private(c.zenith_private), radius(c.radius), elevation(c.elevation_private), zenith(c.zenith_private), azimuth(c.azimuth) {}
 
   //! Assignment operator
   SphericalCoord& operator=( const SphericalCoord &c ){

core/src/Context.cpp

@@ -1,6 +1,6 @@
 /** \file "Context.cpp" Context declarations.
 
-    Copyright (C) 2016-2024 Brian Bailey
+    Copyright (C) 2016-2025 Brian Bailey
 
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by

core/src/Context_data.cpp

@@ -1,6 +1,6 @@
 /** \file "Context_data.cpp" Context primitive data, object data, and global data declarations.
 
-Copyright (C) 2016-2024 Brian Bailey
+Copyright (C) 2016-2025 Brian Bailey
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by

core/src/Context_fileIO.cpp

@@ -1,6 +1,6 @@
 /** \file "Context_fileIO.cpp" Filesystem input/output functions within the Context.
 
-Copyright (C) 2016-2024 Brian Bailey
+Copyright (C) 2016-2025 Brian Bailey
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by

core/src/global.cpp

@@ -1,6 +1,6 @@
 /** \file "global.cpp" global declarations.
 
-    Copyright (C) 2016-2024 Brian Bailey
+    Copyright (C) 2016-2025 Brian Bailey
 
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by

core/src/selfTest.cpp

@@ -1,6 +1,6 @@
 /** \file "selfTest.cpp" Context selfTest() function.
 
-    Copyright (C) 2016-2024 Brian Bailey
+    Copyright (C) 2016-2025 Brian Bailey
 
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by

doc/CHANGELOG

@@ -1985,4 +1985,31 @@ The radiation model has been re-designed, with the following primary additions:
 - Error corrected in radiation camera documentation example code.
 
 *Photosynthesis*
-- Updated code to include stomatal sidedness option (this was already described in the documentation, although it had not been implemented).
+- Updated code to include stomatal sidedness option (this was already described in the documentation, although it had not been implemented).
+
+[1.3.25] 2025-01-03
+
+*Updated copyright dates to 2025*
+
+*Plant Architecture*
+!!! Many significant changes in this release !!!
+- The way leaf prototypes are generated has changed. There is now a modifiable parameter set that controls procedural leaf generation (or loading a model from an OBJ file).
+- Changed generic leaf prototype function to be able to represent leaf "buckling", such as what happens to long leaves of grasses like maize.
+- Removed shoot parameter 'leaf_flush_count'.
+- Added shoot parameter 'max_nodes_per_season' to allow the shoot to stop growing for the season, but continue adding nodes in future seasons.
+- Phenological thresholds for plants have been changed to be realistic (e.g., the phenological cycle for perennial plants corresponds to days in a year).
+- A maximum age limit for plants has been added so users don't inadvertantly specify a very old plant that will cause the program to hang.
+- Changed the way that vegetative bud break probability is handled such that it can vary along the shoot. The relevant parameters are now 'vegetative_bud_break_probability_min' and 'vegetative_bud_break_probability_decay_rate'.
+- Changed the way that downstream leaf area is calculated to improve computational efficiency. This required some changes in the 'girth_area_factor` parameter.
+- Committed all Blender project files used to create organ OBJ models: plugins/plantarchitecture/assets/Blender_organ_models/
+- Moved initial internode radius from being a shoot parameter to a phytomer parameter, since it is constant along the shoot and over time.
+- Added overloaded PlantArchitecture::advanceTime() method that allows to specify the time step in years and days for advancing over long time periods.
+- Changed the name of the shoot parameter 'phyllochron' to 'phyllochron_min' to be consistent with how it will be used in the carbohydrate model.
+- Added actual self-test that builds all plants in the library.
+
+*Visualizer*
+- Problem fixed in freetype zconf.h file that caused build errors on latest MacOS compilers.
+- All output messages were not being properly suppressed after calling disableOutputMessages().
+
+*Canopy Generator*
+- Many edits made regarding how parameters with random variation are handled, mainly to ensure proper constraints on values (e.g., always positive).

doc/UserGuide.dox

@@ -1,4 +1,4 @@
-/*! \mainpage Helios Documentation v1.3.24
+/*! \mainpage Helios Documentation v1.3.25
 
   <p> <br> </p>