1.5.1

WHAT'S NEW:
✨ ⚗️ Added an experimental feature that uses the CVode ordinary differential equation solver to simulate sub-daily soil moisture and nitrogen transport
✨ Improved the simulation of N₂O emissions from denitrification
✨ Added a new phenology algorithm that accounts for vernalization
✨ The model now reports errors when operation day of year is out of range (less than 1 or greater than 366)
🐛 Fixed transpiration output and soil evaporation calculations on harvest days
💄 Changed output file format to csv
💄 Added O₂ and temperature factors for crop growth, and vernalization outputs to crop files
🔨 Added an example Jupyter notebook for running batch simulations and post-processing using the Cycles-utils Python package

NOTE:
Updating to this version requires changes in the crop description file.
Twelve new parameters were introduced to enable the new phenology algorithm. These parameters are PHOTOPERIOD_MIN, PHOTOPERIOD_MAX, THERMAL_TIME_VERNALIZATION, THERMAL_TIME_FLOWERING_AT_PMAX, THERMAL_TIME_GRAIN_FILLING, VERNALIZATION_TEMPERATURE_THRESHOLD_LOWER, VERNALIZATION_TEMPERATURE_THRESHOLD_OPTIMAL, VERNALIZATION_TEMPERATURE_THRESHOLD_UPPER, TEMPERATURE_POST_FLOWERING_LOWER, TEMPERATURE_POST_FLOWERING_OPTIMAL, TEMPERATURE_POST_FLOWERING_UPPER, DEVERNALIZATION_TEMPERATURE. Those parameters are added to the end of the Phenology block in crop description files.

1.4.4

WHAT'S NEW:

1. 🗃️ Corrected 2024 global CO2 concentration to co2.txt input
2. 💬 Fixed the screen output of %

1.4.3

WHAT'S NEW:

1. ✨ Used a five-point averaging for thermal time calculation to improve model thermal time calculation under extreme conditions
2. 🐛 Fixed water balance errors caused by changing soil thicknesses
3. 🗃️ Added 2024 global CO2 concentration to co2.txt input
4. 📦 Included two MacOS packages, for both Intel (intel64) and Silicon (arm64) chips

1.4.1

WHAT'S NEW:

1. ✨ Added correction terms to pedotransfer functions to ensure calculated hydraulic properties match user input
2. ✨ #74 - Added dynamic soil thicknesses due to the change of organic matter and texture
3. ✨ Added a new nitrogen harvest index algorithm. As a result, five new parameters were introduced to crop description files
4. ✨ The model now reports errors when model start date is later than end date
5. ✨ The model now uses the average of max, min, and mean daily temperature for thermal time calculation to improve performance in high temperature
6. 💄 #84 - season.txt was renamed to harvest.txt
7. 💄 Changed soil organic matter input to soil organic carbon in soil description files
8. 🐛 Fixed bug that the weather file range error was not reported correctly
9. 🐛 Fixed a bug that CO2 file could not be read correctly when a path was specified

NOTE:
Update to this version requires changes in soil and crop description files.

1. Soil description file:
   The OM, i.e., organic matter parameter has been changed to SOC, i.e., soil organic carbon. To use previously prepared soil description files with the new version, a factor of 0.58 should be used to convert soil organic matter to soil organic carbon.

2. Crop description file:
   Five new parameters were introduced to enable the new nitrogen harvest index algorithm.
   These parameters are N_MAX_CONCENTRATION_GRAIN, N_MIN_CONCENTRATION_GRAIN, N_MAX_CONCENTRATION_STRAW, N_MIN_CONCENTRATION_STRAW, and N_PARTITIONING_FACTOR.
   They are maximum allowable grain N concentration (%), minimum allowable grain N concentration (%), maximum allowable straw N concentration at harvest (%), minimum allowable straw N concentration at harvest (%), and empirical constant in N partitioning (and applied to winter wheat), respectively.
   Those parameters were added to the end of the Allocation blocks in crop description files.

1.3.0

WHAT'S NEW:

1. ✨ Added effect of CO2 on crop growth, and an annual CO2 concentration input file
2. ✨ Let severe cold damage kill annual crops before maturity
3. ✨ Allowed planting windows to cross years
4. ✨ Avoided physically implausible bulk densities from PTF
5. ✨ Updated soil hydraulic properties after spin-up to reflect the impact of steady-state soil organic carbon.
6. ✨ Added a new grain growth model that can be turned on using the -g command line option
7. ⚡ Improved error handling
8. 💄 Updated control file and multi-mode file formats
9. 🐛 Fixed NaN errors caused by residue evaporation calculation when either standing residue or flat residue becomes 0
10. 🐛 Fixed a bug that 0 shoot biomass at harvest causes harvest index to be nan.

NOTE:
Update to this version requires changes in control and multi-mode files.

1. Simulation control file:
   SIMULATION_START_YEAR and SIMULATION_END_YEAR parameters are now SIMULATION_START_DATE and SIMULATION_END_DATE, and the input format should be YYYY-MM-DD.

   The "input files" block has been moved to up, right below the "simulation years" block.

   A CO2_LEVEL parameter is required in the "simulation options" block, which should be the atmospheric CO2 concentration in ppm.
   This parameters is by default -999, which uses the co2.txt input file in the input directory.

2. Multi-mode file:
   A 'CO2_LEVEL` parameter is required in the multi-mode file.

1.2.1

WHAT'S NEW:

1. ✨ Allow users to customize output extensions using command line option -e
2. ✨ Add more parameters to calibration files
3. ✨ Add a "burn residue" operation
4. ✨ Update soil hydraulic properties after spin-up to reflect the impact of steady-state soil organic carbon.
5. 💄 Rename calibration files to *.nudge
6. 💄 Update ASCII art
7. 💄 Rename command line option -f to -p
8. 🐛 Fix a bug in rotation builder that crops were not planted correctly after building the yield matrix
9. 🐛 Fix a bug that could cause negative microbial C or N pools

1.1.0

WHAT'S NEW:

1. ✨ Fill in missing curve number and slope in soil input
2. ✨ Update harvest index calculation algorithm
3. ✨ Add calibration functionality
4. 💄 Fix operation input file parameter name
5. 💄 Fix crop input file parameter name
6. 🐛 Avoid unreasonable thermal time and N stress

NOTE:
Update to this version requires changes in crop description and management operations files.

1. Crop description file:
   The parameter HARVEST_INDEX should be changed to HARVEST_INDEX_SLOPE_MULTIPLIER, with a default value of 1.0
2. Management operations file:
   For planting operations, the parameter FRACTION should be changed to DENSITY.

1.0.0

WHAT'S NEW:

1. ✨ #68 - When organic nitrogen is present in the fertilizer, organic carbon will be added if not already existed.
2. ✨ 💄 #72 - Specify depth of fertilizer application instead of soil layer in operation files.
3. ✨ 💄 #75 - Add maximum soil temperature constraint for conditional planting.
4. ✨ Fill nitrate and ammonium values in soil files if they are specified as -999.
5. ✨ Check input soil parameters to make sure they are in their physically plausible ranges.
6. ✨ Limit the number of spin-up cycles to 100.
7. 🐛 Fix unreported nitrogen in harvest.
8. 🐛 Fix nitrogen balance errors caused by incorrect nitrogen uptake calculation.
9. ⚡ Improve computational efficiency for conditional planting
10. 💄 Use new crop file format.
11. 💄 Fix some minor format problems in output files.
12. 💄 Extensions of all output files have been changed to .txt.
13. 🗃️ Add databases for fertilizer and tillage (fert.txt and till.txt in the input directory).

NOTE:
Update to this version requires changes in crop description and management operations files.

1. Crop description file:
   The parameters in the crop description files are now categorized by their functionalities. A Jupyter notebook is provided to help convert the format of crop description files.
2. Management operations file:
   For planting operations, a MAX_SOIL_TEMP parameter (degree C) is added as the maximum soil temperature allowed for conditional planting.
   For fertilization operations, the LAYER parameter is now replaced by the DEPTH parameter (meter), to specify the depth of fertilizer application.

0.13.0 alpha

WHAT'S NEW:

1. ✨ Allow running control file in a subfolder inside the input directory
2. 🐛 Fix a bug that re-initialization file is not read in in spin-up mode
3. 🐛 Add missing values for forage harvest to season output file
4. 🐛 Fix a bug in residue calculation during grain harvest
5. 💄 Fix annual SOM output alignment
6. ✨ Improve rotation management in dynamic rotation builder

0.12.9 alpha

WHAT'S NEW:

1. ✨ Schedule harvests with multiple tillage tool names, e.g., Grain_Harvest, GrainHarvest, Harvest_Grain, and HarvestGrain. The same applies to forage harvests.
2. 🐛 Fix a bug that reference ET and precipitation were not printed in environ.dat
3. 🐛 Fix bypass water transport bug in cascade mode
4. 🐛 Improve compatibility with text files of different formats