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

0.12.4 alpha

WHAT'S NEW:

1. 🗃️ Update crop description file
2. ⚡ Improve hydraulic lift simulation