com.powsybl.sensitivity

Class SensitivityComputationResults

java.lang.Object

com.powsybl.sensitivity.SensitivityComputationResults

public class SensitivityComputationResults
extends Object

Sensitivity computation results

Mainly composed of the lists of sensitivity values in N, and optionally in N-1

A single sensitivity computation should return, besides its status and some stats on the computation itself, all the sensitivity values for each factor (combination of a monitoredBranch and a specific equipment or group of equipments). The HADES2 sensitivity provider used with Powsybl offers the possibility to calculate the sensitivity on a set of contingencies besides the N state. The computation is launched only once, but the solver itself modifies the matrix for each state of the network to output a full set of results. In the sensitivity API, it has been allowed to provide a list of contingencies as an optional input, which then triggers such a sensitivity analysis. The full set of results consists of : - the list of sensitivity values in N - the lists of sensitivity values for each N-1 situation - some metadata (status, stats, logs)

Author:

Sebastien Murgey <sebastien.murgey at rte-france.com>

See Also:

SensitivityValue

Constructor Summary

Constructors

Constructor and Description
SensitivityComputationResults(boolean ok, Map<String,String> metrics, String logs, List<SensitivityValue> sensitivityValues)
SensitivityComputationResults(boolean ok, Map<String,String> metrics, String logs, List<SensitivityValue> sensitivityValues, Map<String,List<SensitivityValue>> sensitivityValuesContingencies) Hades2 sensitivity computation results

Method Summary

Modifier and Type	Method and Description
boolean	contingenciesArePresent() Get the status of the presence of contingencies
static SensitivityComputationResults	empty()
String	getLogs() Get computation logs.
Map<String,String>	getMetrics() Get some metrics about computation execution.
SensitivityValue	getSensitivityValue(SensitivityFactor factor) Get the sensitivity value associated with given factor in state N.
SensitivityValue	getSensitivityValue(SensitivityFactor factor, String contingencyId) Get the sensitivity value associated with given factor for a specific contingency
SensitivityValue	getSensitivityValue(SensitivityFunction function, SensitivityVariable variable) Get the sensitivity value associated with given function and given variable in state N.
SensitivityValue	getSensitivityValue(SensitivityFunction function, SensitivityVariable variable, String contingencyId) Get the sensitivity value associated with given function and given variable for a specific contingency.
Collection<SensitivityValue>	getSensitivityValues() Get a collection of all the sensitivity values in state N.
Collection<SensitivityValue>	getSensitivityValuesByFunction(SensitivityFunction function) Get a collection of all the sensitivity values associated with given function in state N.
Collection<SensitivityValue>	getSensitivityValuesByFunction(SensitivityFunction function, String contingencyId) Get a collection of all the sensitivity values associated with given function for a specific contingency.
Collection<SensitivityValue>	getSensitivityValuesByVariable(SensitivityVariable variable) Get a collection of all the sensitivity values associated with given variable in state N.
Collection<SensitivityValue>	getSensitivityValuesByVariable(SensitivityVariable variable, String contingencyId) Get a collection of all the sensitivity values associated with given variable for a specific contingency.
Map<String,List<SensitivityValue>>	getSensitivityValuesContingencies() Get a collection of all the sensitivity values for all contingencies.
boolean	isOk() Get the status of the sensitivity computation

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SensitivityComputationResults

public SensitivityComputationResults(boolean ok,
                                     Map<String,String> metrics,
                                     String logs,
                                     List<SensitivityValue> sensitivityValues,
                                     Map<String,List<SensitivityValue>> sensitivityValuesContingencies)

Hades2 sensitivity computation results

Parameters:

ok - true if the computation succeeded, false otherwise

metrics - map of metrics about the computation

logs - computation logs

sensitivityValues - result values of the senstivity computation in N

sensitivityValuesContingencies - result values of the senstivity computation on contingencies

SensitivityComputationResults

public SensitivityComputationResults(boolean ok,
                                     Map<String,String> metrics,
                                     String logs,
                                     List<SensitivityValue> sensitivityValues)

Method Detail

isOk

public boolean isOk()

Get the status of the sensitivity computation

Returns:

true if the computation is ok, false otherwise

getMetrics

public Map<String,String> getMetrics()

Get some metrics about computation execution. Content may vary a lot depending of the implementation

Returns:

the metrics of the execution

getLogs

public String getLogs()

Get computation logs.

Returns:

the computation logs

getSensitivityValues

public Collection<SensitivityValue> getSensitivityValues()

Get a collection of all the sensitivity values in state N.

Returns:

a collection of all the sensitivity values in state N.

getSensitivityValuesByFunction

public Collection<SensitivityValue> getSensitivityValuesByFunction(SensitivityFunction function)

Get a collection of all the sensitivity values associated with given function in state N.

Parameters:

function - sensitivity function

Returns:

a collection of all the sensitivity values associated with given function in state N.

getSensitivityValuesByVariable

public Collection<SensitivityValue> getSensitivityValuesByVariable(SensitivityVariable variable)

Get a collection of all the sensitivity values associated with given variable in state N.

Parameters:

variable - sensitivity variable

Returns:

a collection of all the sensitivity values associated with given variable in state N.

getSensitivityValue

public SensitivityValue getSensitivityValue(SensitivityFunction function,
                                            SensitivityVariable variable)

Get the sensitivity value associated with given function and given variable in state N.

Parameters:

function - sensitivity function

variable - sensitivity variable

Returns:

the sensitivity value associated with given function and given variable in state N.

getSensitivityValue

public SensitivityValue getSensitivityValue(SensitivityFactor factor)

Get the sensitivity value associated with given factor in state N.

Parameters:

factor - sensitivity factor

Returns:

the sensitivity value associated with given function and given variable in state N.

contingenciesArePresent

public boolean contingenciesArePresent()

Get the status of the presence of contingencies

Returns:

true if the computation contains contingencies, false otherwise

getSensitivityValuesContingencies

public Map<String,List<SensitivityValue>> getSensitivityValuesContingencies()

Get a collection of all the sensitivity values for all contingencies.

Returns:

a collection of all the sensitivity values for all contingencies.

getSensitivityValuesByFunction

public Collection<SensitivityValue> getSensitivityValuesByFunction(SensitivityFunction function,
                                                                   String contingencyId)

Get a collection of all the sensitivity values associated with given function for a specific contingency.

Parameters:

function - sensitivity function

contingencyId - the ID of the considered contingency

Returns:

a collection of all the sensitivity values associated with given function for the given contingencyId

getSensitivityValuesByVariable

public Collection<SensitivityValue> getSensitivityValuesByVariable(SensitivityVariable variable,
                                                                   String contingencyId)

Get a collection of all the sensitivity values associated with given variable for a specific contingency.

Parameters:

variable - sensitivity variable

contingencyId - the ID of the considered contingency

Returns:

a collection of all the sensitivity values associated with given variable

getSensitivityValue

public SensitivityValue getSensitivityValue(SensitivityFunction function,
                                            SensitivityVariable variable,
                                            String contingencyId)

Get the sensitivity value associated with given function and given variable for a specific contingency.

Parameters:

function - sensitivity function

variable - sensitivity variable

contingencyId - the ID of the considered contingency

Returns:

the sensitivity value associated with given function and given variable

getSensitivityValue

public SensitivityValue getSensitivityValue(SensitivityFactor factor,
                                            String contingencyId)

Get the sensitivity value associated with given factor for a specific contingency

Parameters:

factor - sensitivity factor

contingencyId - the ID of the considered contingency

Returns:

the sensitivity value associated with given function and given variable

empty

public static SensitivityComputationResults empty()