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

0.12.7 alpha

WHAT'S NEW:

1. 🐛 Fix N balance errors caused by negative solute fluxes

0.12.6 alpha

WHAT'S NEW:

1. ✨ Allow using weather files without leap years
2. ✨ Use 7-day moving average soil temperature for conditional planting constraints. Previously only the current day soil temperature was taken into account.
3. ✨ In the operation files, use fractions between PWP and FC for conditional planting constraints. Previously absolute soil water content values were used.
4. 🐛 Fix some potential NAN errors in soil moisture and soil carbon/nitrogen processes.
5. ⚡ Improve Python scripts
6. 💄 Rename weather.dat output file to environ.dat, and add soil temperature and vapor pressure deficit to the environ.dat output file.
7. 💬 Print simulation name when reporting errors in multi-mode simulations

0.12.5 alpha

WHAT'S NEW:

1. ✨ Allow scheduled harvest/kill operations to override -999 clip start date
2. 🐛 Skip transpiration calculation when radiation interception is 0
3. ⚡ Improve model stability under dry conditions
4. 💬 Improve error reporting
5. 🗃️ Fix crop parameters in crop description file