                     Changes in version 2025-06-03                      

  - FUNCTIONS
    
      - convert_xml2txt allows to convert sols.xml file to text files
      - Some useless functions have been removed and functions help
        updated
      - download_data is now fail with an informative message if the
        internet resource is not available
      - set_param_xml.R: consistency for save_as and overwrite arguments
        and messages improvement
      - file_document class: useless type slot removed
      - general code re-formatting and cleaning

  - FIXES
    
      - get_param_xml: management of empty strings values in XML files
      - removed use of library() in tests

  - DATA
    
      - Added a missing parameter (concrr) in the excel files templates

  - VIGNETTES
    
      - Added a stopping message when the download_data function fails
        (e.g. no internet connection or resource not available)

                     Changes in version 2024-11-13                      

  - FUNCTIONS
    
      - New functions for generating xml general parameters files
      - New function for copying .mod, .obs, .lai and weather
        (climat.txt) files

  - FIXES
    
      - pattern to get obs files for intercrop usms or sole crops usms
      - generation of xml parameters files

  - DATA
    
      - Added information about the latest STICS version 10.2.0

                     Changes in version 2024-07-16                      

  - FUNCTIONS
    
      - New functions for computing dates from days numbers with
        reference to starting year
      - compute_day_from_date now uses a start year instead of a date,
        and date may of type character
      - get_param_txt, set_param_txt, get_param_xml, set_param_xml now
        use values ids for getting or setting specific parameter vector
        values specific values
      - New functions for getting cultivars list and extracting
        cultivars parameters as a data.frame

  - FIXES
    
      - management of STICS version consistency with text files content
        using get_param_txt or set_param_txt

                     Changes in version 2024-04-10                      

  - FUNCTIONS
    
      - Message improvement for missing xml files detected before text
        files generation
      - New functions for computing days numbers from dates with
        reference to starting dates

  - FIXES
    
      - Updating STICS versions information
      - get_file using usm names (regex pattern)
      - upgrade _ini.xml file (magrain0 parameter position)
      - xml files generation: missing data management when loading
        xls/csv files
      - text files generation: plant and tec files were not generated in
        intercropping usms for the associated crop

  - DOC
    
      - added license file

                     Changes in version 2024-02-21                      

  - FUNCTIONS
    
      - Text files generation from xml files are now done without using
        JavaSTICS command line (the speedup is about 10 times)
      - Getting parameters information (get_param_info) do not use XML
        files exploration anymore, the speed is largely improved
      - Improvement of XML files manipulations/generation for reducing
        memory use/freezing in R when intensive use is performed
      - tests coverage improvement

  - FIXES
    
      - update of a bunch of unit tests according to other packages
        evolution
      - STICS versions management and XML files upgrade

  - DATA
    
      - examples, templates files for different files format added for
        the latest STICS version 10.1.0
      - versions meta-data update

                     Changes in version 2023-07-10                      

  - FUNCTIONS
    
      - New function for generating the new_travail.usm STICS file
      - New function for generating weather data files (climat.txt)
      - New unit tests added

  - FIXES
    
      - get_param_value: forcing to get a character returned value
      - get_var_info: for variables names vector
      - get_param_txt: removed global variables use, looking for
        parameters names including parentheses
      - code formatting, comments, file names, variables names, function
        names,...
      - package namespace use in packages functions calls
      - pattern for replacing parameters names were are not consistent
        between XML files and inputs.csv
      - pattern for selecting parameters in Excel files, filtering
        parameter starting with "code_"
      - renaming plant initialization parameters according to crop
        number tag (Crop1, Crop2)
      - tidyselect and filter syntax
      - homogeneous naming of JavaSTICS and STICS

  - DATA
    
      - added: meta-data and xsl files for converting XML files to text
        files for STICS
      - examples files for different files format used in the package
        are now distributed as zip files for lightening the extdata
        directory

                     Changes in version 2022-12-16                      

  - FIX:
      - Fix for cff file generation using a GitHub action

                     Changes in version 2022-12-08                      

  - FUNCTIONS
    
      - Changes in plant files upgrading function according to a fix
        done in JavaSTICS 1.5.1 for plant files (without any impact on R
        packages functioning)

  - FIXES:
    
      - Little compatibility fix in STICS plant files upgrading function

                     Changes in version 2022-10-28                      

Following the changes done in the previous release 1.0.0, related to the
adaptation to the new versions 10.0 of STICS and 1.5.0 of JavaSTICS.

  - FUNCTIONS:
    
      - Completion of the upgrade function for converting plant files
        from STICS 9.x versions to the latest STICS version 10.0

  - FIXES:
    
      - Getting parameters values attached to a formalism
      - Parameters with no values are now handled (*_tec.xml files) with
        NA values
      - Some fixes about use of XML objects or lists of (kind, content)
        in tests

                     Changes in version 2022-07-22                      

The main changes are mainly related to the adaptation to the new
versions 10.0 of STICS
and 1.5.0 of JavaSTICS, to homogenization of arguments names in
functions and to fixes.

  - FUNCTIONS:
    
      - New set of functions for upgrading XML files of STICS
        version 9.2 to STICS version 10.0 (either each kind of XML file
        or a whole workspace)
      - Homogenization of arguments names in functions
      - Some functions have been moved from the SticsOnR package into
        the SticsRFiles
      - Improvement of functions dedicated to java/JavaSTICS command
        line use, added checks

  - FIXES:
    
      - Extraction of vectorized parameters from _tec.xml and _ini.xml
        files
      - Functions for getting and setting parameters values in STICS
        input text files:
          - parameters of _ini.txt files now taken into account
          - taking into account special characters in parameter names
            ("_", "(", ")")
          - get function now returning result in an homogenized format
            (list of parameters) whatever is the value of argument param
      - Reading STICS daily outputs: NA or missing values now handled
      - Whitespaces now taken into account in dir/file path

  - DOC:
    
      - New vignette on functions for upgrading XML files of STICS
        version 9.2 to version 10.0 format
      - Adaptation of the vignettes to STICS version 10.0
      - SticsRFiles tutorial moved into SticsRPacks tutorial

  - DATA: New files for STICS 10.0
    
      - XML example files added
      - Data set of text parameters files
      - XL file example for generating XML files

  - TESTS:
    
      - Adaptation of existing tests to STICS 10.0
      - New tests for XML files generation

                     Changes in version 2021-10-07                      

  - Prepared templates for STICS V10.

  - FIXES:
    
      - Bugs fixed for generation of soil, ini and tec XML files from
        excel files.
    
      - Fixed reading of observation and simulation results files in
        case of USM selection (arg. usm_name)
    
      - tec file of associated plant no more searched in case of a
        single plant in gen_usms_xml2txt

  - DOC:
    
      - Completed doc for generation of XML files from excel files.
    
      - Updated general doc.

                     Changes in version 2021-07-02                      

Changes

  - FIX: force_param_values() did not work for parameters which names
    included parenthesis
    
      - Added dependency to dplyr >= 1.0.0 due to use of relocate
        function
    
      - Typos in doc

                     Changes in version 2021-04-15                      

General changes

  - DESCRIPTION
      - Imports: lifecycle
    
      - Tests
        
          - new ones added for : gen_tec_xml, gen_ini_xml
    
      - Functions:
        
          - Now managing functions life cycle
    
      - Files:
        
          - useless XML template files have been removed

Specific changes

  - get_sim: new function replacing get_daily_results
    
      - get_daily_results: has been set to deprecated (a warning is
        displayed)
    
      - set_param_value: changed error output to warning if any
        parameter name does not exist
    
      - gen_tec_xml: now taking into account specific parameters linked
        to cut crops management
    
      - gen_ini_xml: fix for crop identifiers management (plant 1 or 2)
    
      - get_usms_list: changed error output to warning when the usms
        file does not exist
    
      - force_param_value: now uses either parameters names including ()
        or _ for indexed ones (for example lai(n) or lai_n)
    
      - get_param_xml, set_param_xml: checks have been added for
        detecting parameters duplicates in tec files

                     Changes in version 2021-01-15                      

General changes

  - DESCRIPTION
    
      - Suggests: formatR, readxl
      - added missing packages: curl, tidyr, tibble
      - license changed to License for CeCILL-C
      - Travis configuration removed

  - README:
    
      - Travis badge removed
      - GitHub Actions R-CMD-check badge added

  - Functions:
    
      - useless functions have been removed
      - some functions have been renamed or generalized

  - Tests
    
      - new ones added for : get_var_info, get_obs, get_daily_results,
        force_param_values
      - test-get*: now using get_examples_path function, some fixes

  - Documentation
    
      - vignettes and tutorial: anchor_sections set to FALSE, fixes on
        warnings and errors, using paged html tables
      - functions help: content fixes and completion (parameters,
        examples, setting examples to dontrun, ...)

  - Fixes
    
      - exported/unexported functions list
      - CRAN issues for checks

  - Automatic testing:
    
      - Github Actions added for checks
      - Travis checks removed
      - SticsRTests Travis tests triggering removed

Specific changes

  - get_obs, get_daily_results: removed useless columns from return,
    simplification

  - download_usm_xl, download_usm_csv: added verbose argument for
    masking warnings/displays, added overwriting case

  - read_params_table : new function for getting parameters tables
    either from csv files or excel files sheets

  - get_param_txt: added varieties management, earlier return when param
    is null, catching names ending with numerical indices, get varietal
    parameter, reading now parameters attached to several layers or
    fertilizations, added examples files for STICS version 8.5

  - Manipulating_Stics_XML_files.Rmd: using XML file for the latest
    model version for displaying files fragments as examples

  - get_stics_versions_compat, manage_stics_versions.R: added NA
    management in data

  - get_file: added plant names in output (for obs and daily data),
    fixed issue and tests added for intercropping case

  - get_daily_results: renamed class attribute to cropr_simulation, use
    of tibble::as_tibble(), mixed calculation using get_plants_nb,
    always returns a list, added optional usm_name arg, uses now
    get_plant_name instead, added javastics_path argument if plant files
    are located in it, dual variables name syntax (i.e. lai_n or lai(n)
    for example), taking into account intercrops management

  - functions refactoring for getting observations and daily outputs

  - get_var_info: now using partial matching on name column also

  - static_help: new function for generating html files from package
    functions help, some fixes and updates for vignettes

  - new function for downloading csv files from examples

  - new functions for managing model versions information and examples

  - get_obs* functions: fixes and optimization, added associated data
    and tests

  - force_param_values: fix for one line tibble

  - set_param_xml: output dir checking

  - force_param_values: new function for forcing model parameters

  - get_report_results: new function for extracting data from reports
    files

  - get_param_info: added using of a specific XML file, attribute for
    STICS version, unique for parameters names list, building a filter
    before dplyr::filter

  - functions added to manage STICS versions data

  - get_obs, get_plant_name: using usms.xml file outside of a STICS
    workspace, parsing mixed crops, file checking,usms_list renamed as
    usm_name

  - gen_*_xml functions: fix for usms name column

  - get_plant_name: getting now plant files list outside mapply call

  - get_param_value: returns a named list even if only one parameter,
    fix for param_name nb > 1, without parameters names in args;returned
    for each file

  - xmlDocument class: fix for checking ids validity

  - removed useless scripts for generating XML files

  - get_plants_nb: is now an interface to get either plants number from
    an xml file or a text file, returning an usms named vector

  - download_data: fix select

  - gen_usms_xml2txt: silent error when blanks in workspace_path, fix
    javastics workspace use,

  - get_stics_versions_compat: all data as character, study_case_1 added

  - gen_usms_obs: added usms_list

  - All functions code and help now using the get_examples_path function

  - get_examples_path: new function for getting files examples according
    to their type (txt, XML, csv,...) and embedded STICS versions data

  - gen_varmod: forcing to add variable not in STICS output variables
    for a given version, now checks if a variable exists, dual variable
    syntax (i.e. lai_n or lai(n))

  - set_param_txt: set value per soil layer, per variety

  - get_usms_files: taking into account 2 plant files folders (but
    without duplicates checks), taking into account varieties management

  - get_usms_list: returns now a character vector of usms names

  - get_param_xml: without parameters names in args;returned for each
    file, name of the XML file added to the output

                     Changes in version 2020-02-03                      

  - Added a NEWS.md file to track changes to the package.

                        Changes in version 1.7.3                        

  - FUNCTIONS
    
      - refactoring and new function to get observations data standard
        deviation or generate a file as for observation files (same
        format).
      - deprecation of usms_list argument replaced with usm for get_obs
        function

  - FIXES
    
      - get_param_txt: plant list initialization
      - set_param_txt: plants ids management according to files type,
        ini parameters management

  - TESTS
    
      - new tests for rewriting xml files functions
      - new tests added for get_usms_files (files existence, usms and
        file types selection)

                 Changes in version 1.7.2 (2026-10-07)                  

  - FIXES
    
      - managing errors/warnings messages for data download preventing
        stopping if internet resources are not available
      - managing mandatory parameters checking (empty values) for 'xml'
        files and activate it in 'gen_tec_xml'
      - get example data path in case of multiple files types

  - FUNCTIONS:
    
      - New utils functions for checking mandatory parameters values
        (technical files)
      - Added tests (download_data,...)
      - Added cache use for XML files generation and transformation
      - Code styling improvement

  - DOCUMENTATION
    
      - NAMESPACE and DESCRIPTION update (authors, imports, known words
        dictionary)
      - Package vignette update for displaying warning when internet
        resources are not available

                        Changes in version 1.7.1                        

  - FIXES
    
      - managing cutting parameters according to 'codemodfauche'.

  - DOCUMENTATION
    
      - NAMESPACE and DESCRIPTION update
      - gen_tec_doc help and comments

                 Changes in version 1.7.0 (2026-09-14)                  

  - FUNCTIONS
    
      - Added new functions for upgrading STICS input files from
        version 10 to version 11
      - Management of STICS versions using the 'semver' package (major,
        minor, patch components)
      - Removed useless warnings in some functions
      - Using now get_version_num function for comparing versions (using
        'svlist' object from 'semver' package)
      - new function get_dev_stages for extracting STICS development
        stages dates from a list of data.frame of simulations outputs
      - parallelisation mode introduced for STICS inputs text files
        generation
      - parallelisation mode introduced for reading STICS output files
      - new function for extracting a new xml workspace from a
        workspace, with possible usm selection (rewriting usms.xml,
        sols.xml)
      - new function for calculating an approximate value of vapor
        pressure
      - manage branches use in download_data function
      - Added verbosity use in functions managing Stics variables and
        replaced warning by message in some cases

  - DOCUMENTATION
    
      - functions help: added missing examples for exported functions
      - vignettes update: for STICS files upgrading

  - FIXES
    
      - Download function for examples csv files
      - Function for reading csv or xls examples files
      - managing text version to version number using 'semver'
      - Remove overwrite argument from set_xml_file_version
      - rename STICS 'humirac' parameter to code_humirac following
        fortran code
      - find general parameters files, .mod files location (either in
        workspace or in JavaStics 'config' directory)
      - manage duplicate values or files in gen_climate function
      - get_xml_files_param_df: for the long format table the "value"
        column is converted to character for binding data.frame rows,
        data selection with parameters names, management of empty
        parameters values when pivot_wider
      - getting plants names with or without using the usms.xml file,
        for mixed usms directories (soles crops and intercrops)
      - set_param_value: converting parameters values to a list if it is
        not a list when dimensions are compatible
      - writing errors for weather data files
      - functions arguments renaming to have more consistency among
        functions
      - compute_date_from_day returns NA instead of 999
      - removed old deprecated arguments management (and 'lifecycle'
        dependency)
      - sub-directories detection for reading observation and simulation
        outputs files, and duplicates
      - download_data: error management
      - fixed default values for mandatory parameters in _tec.xml
        templates files (V10 and V11)
      - Added checks for calculating weather data years number and added
        new tests

  - DATA
    
      - Input STICS files sets: simplification according to versions
        compatibility
      - Update examples files for STICS version 11.0.0
      - adaptation of functions used for data manipulation for new data
        set of STICS 11.0.0

  - REFACTORING
    
      - Removed useless code, superfluous arguments and commented code
      - Checking version function
      - Functions simplification for upgrading files from STICS
        version 9 to 10
      - code style fixes

  - TESTS
    
      - Checks and integration tests restructured
      - Use of an automatic action for checking code style and updates
      - Updates about 'testhat' function used
      - Added in workflows a dependabot for checking packages updates
        (producing pull requests)
      - Removed from tests useless version number

                        Changes in version 0.4.0                        

General changes

  - DESCRIPTION / NAMESPACE: updates linked to new functions
    
      - Tests
        
          - updates, new ones added (get_obs, get_sim)
    
      - Functions:
        
          - new: get_lai_forcing, check_usms_files
          - help updates
          - help reference site update (gen_obs function)
    
      - Files:
        
          - some useless files removed
          - new STICS dirs added (needed by tests)
          - fix: example dirs names in inst
    
      - Tutorial: minor fix for use-xml-files (working dir creation)

Specific changes

  - get_sim / get_obs / get_file / get_file_ refactoring added some
    controls now taking into account a usms file path in functions fixed
    issues related to intercrops data loading added data.frame columns
    detection for filtering data on dates
    
      - functions for manipulating xml files taking into account a new
        kind of STICS parameter dependency (for plant and soil layers
        dependent parameters)
    
      - set_param_txt: fix for setting values for varietal parameters
    
      - gen_obs: fixes generating multiple files from a sheet generating
        files from a single observed variable
    
      - gen_usms_xml2txt now compatible with lai forcing added optional
        argument for checking files now removing files before each files
        generation
