Copyright © 2016 RTE Reseau de transport d’electricite
ENHANCEMENT :
importZipStudyWeb() zip study with new package zipinstead of utils::zip (more faster)createLink()/ editLink() check the number of rows of dataLink and tsLink if providedupdateOptimizationSettings() add missing properties and update possible values by propertyrunSimulation() poll each 300s instead of 1s to get the status of the job to avoid too many queries for Antares WebDOCUMENTATION :
setThematicTrimming() add example to show how to update a list of variablesBUGFIXES :
.st_mandatory_params() property efficiencywithdrawal is not a ratio and can be greater than 1.createStudy() Since Antares 9.2, property initial-reservoir-levels in generaldata/other preferences is not needed. This property must be removed.createClusterST() Ensure that if a storage is created with overwrite set to TRUE, the storage is overwrittencreateLink()/ editLink() booleans is.null(tsLink) and is.null(dataLink) can change inside the function (rollback to previous version)BREAKING CHANGES :
api_command_execute() Since Antares Web 2.31.0, the endpoint v1/tasks/<task_id> sends a property returnValue instead of return_valueNEW FEATURES :
createDistrict() uses a specific endpoint to create the districteditDistrict() allows the user to edit a district. Use of a specific endpoint in API mode.ENHANCEMENT :
createBindingConstraint()/editBindingCOnstraint() : remove depency to readClusterDesc() from antaresRead packageBUGFIXES :
.get_version_solver_from_path_solver() get solver version by running command line instead of searching in the path.OPTIMIZATION :
createBindingConstraintBulk() reads links and clusters of the study once(cf. Antares v9.3 changelog)
NEW FEATURES :
createClusterST()/editClusterST() :
storage_values_default())createClusterST()/editClusterST() :
createCluster() :
updateScenarioBuilder() New types of series "sts" and "sta" ("sct apports level" and "sct contraintes") is availableBUGFIXES :
createBindingConstraint()/editBindingConstraint() do not allow to create/edit a binding constraint if a cluster referenced in a coefficient does not exist.(cf. Antares v9.2 changelog)
NEW FEATURES :
createStudy() initializes the study by updating the generaldata.ini file :
shedding-policy parameter is changed to "accurate shave peaks"hydro-pmax = "daily"createArea() initializes the hydro.ini file with a new parameter overflow spilled cost difference (for each area)createClusterST()/editClusterST() : Parameter group is now dynamic and have no restrictioncreateClusterST()/editClusterST() :
storage_values_default())removeClusterST() : remove New optional time series + New additional constraintsupdateScenarioBuilder() New type of series "hfl" ("hydro final level", similar to "hydrolevels") is availableremoveDistrict() remove a district from a studycreateArea()/editArea(): in API mode, allow the user to customize localization and color of an areaNEW FEATURES (other) :
editBindingConstraint() : control the dimensions of the matrix only if a time series is provided by the user for optimization.createCluster() uses a specific endpoint to write cluster's metadata and commands to write matrixsetThematicTrimming() to set the thematic trimming in file generaldata.inicreateStudy()* adds author in study.antares filecreateClusterST() : For a study < v9.2, execution will be STOP if group is not included in list (see doc)
updateAdequacySettings() : Two parameters (enable-first-step, set-to-null-ntc-between-physical-out-for-first-step) are deprecated and removed. Parameters are forced to NULL with study >= v9.2.BUGFIXES :
clearScenarioBuilder() in API mode, updates correctly with empty data ({})A new article exposing new features of Antares Simulator v9.2 is available here
(cf. Antares v9 changelog)
NEW FEATURES (Antares v9.0) :
createStudy() takes into account the new format of Antares studies (e.g. 9.0, 9.15 instead of 900, 915)BUGFIXES :
editBindingConstraint() :
operator parameter set to NULL, by default, no longer causes an error.operator parameter is now required.filter-year-by-year and filter-synthesis properties are retained in the .ini file if they are not modified.api_command_execute() manage snapshot generation of a variant study with a tempo to wait the end of current task (prevents the order from being ignored).
verbose to TRUE (#274 antaresRead) to display diagnostic messages (getOption("antares"))updateAdequacySettings() : in API mode do not send NULL valueGITHUB ACTIONS :
createBindingConstraint() / editBindingConstraint() uses metadata to check the group size of time series.createBindingConstraintBulk() checks consistency of groups passed as parameters and consistency with the study.importZipStudyWeb() can delete the zipfile and move the study in Antares Web to another folderantaresRead-reexports.R and adjust scripts to have a clean packageremoveArea() : send a warning instead of a stop if an area is referenced in a binding constraint coefficientremoveLink() : send a warning instead of a stop if a link is referenced in a binding constraint coefficientremoveCluster() : send a warning instead of a stop if a cluster is referenced in a binding constraint coefficientcreateClusterST() : updated with new endpoint API (POST + PUT)editClusterST() : updated with new endpoint API (PATCH + PUT)removeCluster()/removeClusterRES()/removeClusterST() updated with new endpoint API (DELETE)NEW FEATURES (Antares v8.8) :
updateOptimizationSettings() allows the user to update solver.log propertycreateClusterST() / editClusterST() use new parameters and default valuesapi_patch() to put PATCH (httr) request to APIBUGFIXES :
createBindingConstraint() in API mode (for study <v870) created with "hourly" timeStep all the timecreateBindingConstraint() / editBindingConstraint() in TEXT mode, bad values in time seriescreateBindingConstraintBulk() with no VALUES and with a mix.check_bulk_object_dim() even if the values are not in first position in the listeditLink() : avoid NULL value (default) for arguments filter_synthesis and filter_year_by_year to write an empty stringupdateOutputSettings() : in API mode, allow the user to edit the desired propertysetPlaylist(): do not send NULL value if the weights are not provided in argumentOTHER UPDATES :
updateGeneralSettings() : replace custom.ts.numbers argument by custom.scenario and deprecate custom.ts.numbersupdateGeneralSettings() : add thematic.trimming argument for editionDOC :
createClusterST() : update doc to discrabe st-storage list parameters + "Inflows" parameterScenarized RHS for binding constraints
NEW FEATURES (Antares v8.7, cf. Antares v8.7 changelog) :
createBindingConstraint() / createBindingConstraintBulk()
groupvalues is now list of data.frameeditBindingConstraint()
groupvalues is now list of data.frameremoveBindingConstraint() can now delete coupling constraints from the group parameter.
scenarioBuilder() has 3 new parameters dedicated to use with binding constraints.
updateGeneralSettings() adds coupling constraints to the scenariobuilder.dat file.
createBindingConstraint() is available with offset parameter in API modeBREAKING CHANGES :
.getJobs()BUGFIXES :
createArea()/editArea() : in API mode, split data in nodalOptimization argument to write it in the expected fileseditArea() : not delete one of the two economic options if only one must be editededitArea()NEW FEATURES :
deleteStudy() with new parameter simulation to delete a simulation in an Antares study.geographic.trimming in updateGeneralSettings()to activate or deactivate this general parameter.importZipStudyWeb() to allow the user to import a local study in Antares WebsetPlaylist() optimized for the API mode
setSimulationPath() and setSimulationPathAPI().createCluster() uses data.table::fwrite() instead of utils::write.table() for optimizationcreateCluster() parameter list_pollutants default value to NULL.createBindingConstraint() parameter coefficients must be alphabetically ordered..createCluster() default matrix in API mode.removeArea() :
removeLink() : control the existence of a link a in a binding constraint coefficient before deletionremoveCluster() : control the existence of a cluster a in a binding constraint coefficient before deletioncreateClusterST() : add a control to check if a cluster exists before running actions.editClusterST() : add a control to check if a cluster exists before running actions..removeCluster() : add a control to check if a cluster exists before running actions in st-storage mode.custom-scenario property in generaldata.ini by himselfBUGFIXES :
filter_synthesis and filter_year_by_year parameters of editLink() in API modesetPlaylist() works in API and local mode with weights.getPlaylist() works in API and local mode with weights.createDSR() in API mode : daily binding constraint takes 366 rows.createCluster() and editCluster() parameter list_pollutants stop if Antares Version < 8.6.0getJobs() no longer returns duplicates and displays the two new columns owner_id and owner_name.updateScenarioBuilder()scenarioBuilder() matrix has the same row repeated if the area is not randcreateLink() to update opts in API mode.editClusterST() : can not edit a cluster if it does not exist in API mode.updateScenarioBuilder() works for NTC part : allow cartesian in the merge.api_command_execute() :
removeCluster() no longer deletes everything in the folder preproantaresRead (see cran-comments.md for details)writeInputTS() allows the user to set a link with the separator ' - ' (ex: 'area1 - area2')BUGFIXES :
createStudy() integrate "st-storage".createArea() integrate "st-storage".removeArea() integrate "st-storage".writeInputTS() integrate "mingen" data and dependency between "mod.txt" and "mingen.txt" data.createCluster() / editCluster() have new parameter list_pollutants for list of pollutants.NEW FEATURES (Antares v8.6) :
activateST() Activate "st-storage" in an Antares study.createClusterST(), editClusterST(), removeClusterST() ("st-storage" family of functions for a study in "input" mode)mingen.txt and mod.txt based on values in hydro.ini filemingen.txt and maxpower.txt based on values in hydro.ini fileenable-first-step in adequacy patch section in settings/generaldata.iniNEW FEATURES :
deduplicateScenarioBuilder() function to keep the last value if a key is duplicated in settings/scenariobuilder.datwriteIniHydro() function to make easier the edition of the input/hydro/hydro.ini filewriteIniHydro() in createArea() and removeArea()settings/scenariobuilder.dat by using scenarioBuilder() and updateScenarioBuilder()deduplicateScenarioBuilder() function to keep the last value if a key is duplicated in settings/scenariobuilder.datwriteIniHydro() function to make easier the edition of the input/hydro/hydro.ini filewriteIniHydro() in createArea() and removeArea()removeArea() removes only expected files in links directorydeleteStudy() no longer requires user confirmationapi_command_execute() displays an error message and causes the program to stop following an http error code. The error message is completed with the API error descriptiongetPlaylist() is compatible with the new format returned by readIniAPI()removeClusterRES() in API moderemoveLink() delete properly data for an Antares version >= 820rollback_to_previous_data() enable to rollback if original value is NULLwriteInputTS() allows the user to set a link with the separator ' - ' (ex: 'area1 - area2')BUGFIXES :
api_command_execute() add timer to request apiwriteInputTS() works with argument type = "tsLink"createLink() and editLink() write the appropriate time series in _direct.txt and _indirect.txt files even if the areas from and to given as arguments are not sortedNEW FEATURES :
deleteStudy() (API compatible)copyStudyWeb() to import physical study into a managed study (API).createClusterBulk() to create multiple thermal clusters at once.writeHydroValues() to write hydro input files.backupStudy()BUGFIXES :
removeArea().writeEconomicOptions() in API mode.NEW FEATURES :
convertConfigToAdq() for migration of older adequacy patch studies into v8.5updateAdequacySettings() has new arguments (cf. Antares v8.5 changelog).createColumns() to create headers of output data when missing.cleanUpOutput() to delete any extra output files not selected in simulation.computeOtherFromHourlyMulti() and computeOtherFromHourlyYear() for mc-ind aggregation. computeTimeStampFromHourly() is now deprecated.BUGFIXES :
writeOutput() and writeAntaresOutput() (support V8)editClusterRES()createClusterRES()getPlaylist() and setPlaylist() in API modeBUGFIXES :
editCluster() in API modecreateVariant()createCluster() and createClusterRES()result-format to choose output format (txt/zip) + new values for transmission-capacities parameter.updateAdequacySettings() function to activate Adequacy Patch and set parameters. + createArea() and editArea() support for new adequacy_patch.ini file.createLink() and editLink() have a new argument tsLink allowing to write transmission capacities time-series.createBindingConstraintBulk() allow to create multiple binding constraints at once.writeInputTS() has changed, data is now in first place.This release include some new features to interact with Antares Web.
createArea(), editArea(), removeArea(), createLink(), editLink(), removeLink(), createCluster(), editCluster(), removeCluster(), createBindingConstraint(), editBindingConstraint(), removeBindingConstraint(), createDistrict(), updateGeneralSettings(), updateInputSettings(), updateOptimizationSettings(), updateOutputSettings(), updateAdequacySettings(), writeInputTS(), readScenarioBuilder(), updateScenarioBuilder(), clearScenarioBuilder(), writeWaterValues(), createDSR(), createPSP().useVariant(), createVariant().createStudyAPI().searchStudy().setAPImode().createStudy() no longer return TRUE / FALSE, but simulation options list returned by antaresRead::setSimulationPath().This release include some new features to interact with renewable energy sources (new in Antares v8.0.3):
activateRES() to use new RES features in an Antares study.updateOptimizationSettings() has a new argument renewable.generation.modelling that can take as value: NULL|aggregated|cluster.createClusterRES() to create a new renewable cluster.editClusterRES() to edit an existing renewable cluster.removeClusterRES() to remove a renewable cluster.readScenarioBuilder(): there can be a new field r if a scenario is completed for renewablesupdateScenarioBuilder(): allow to update scenario builder for renewables if RES activated.updateGeneralSettings(): check value for inter.modal and inter.modal parameters:
updateInputSettings(): prevent use of renewables for import parameter.updateScenarioBuilder() has a new argument clusters_areas = <data.table> to specify area/cluster to use for thermal/renewable series.clearScenarioBuilder() to clear a ruleset from the scenario builder.getPlaylist : V8 antares ponderation.setPlaylist : V8 antares ponderation.copyOutput : to copy antares output with extension.writeOutputValues : to write antares data after antaresRead (areas, links and clusters).computeTimeStampFromHourly : to write mc-ind data from hourly files (daily, weekly, monthly and annual).parAggregateMCall : to compute mc-all from md-ind.editArea : to edit an area.editBindingConstraint : to edit a Binding Constraint.createStudy() for Antares version >= 7.1.0writeSeriesPrepro(): to write load, wind and solar prepro data.writeInputTS(): writes input time series.scenarioBuilder() can write thermal scenario.writeEconomicOptions(): to create or edit economic options.nodalOptimizationOptions() has two new arguments: average_unsupplied_energy_cost and average_spilled_energy_cost.scenarioBuilder() now work when areas_rand has length 1createPSP to work with Antares v7NEWS.md file to track changes to the package.