Interface Scalable
-
- All Known Implementing Classes:
DanglingLineScalable
public interface Scalable
- Author:
- Geoffroy Jamgotchian
, Ameni Walha
-
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static class
Scalable.ScalingConvention
Sign convention usable for scaling.
-
Method Summary
All Methods Static Methods Instance Methods Abstract Methods Default Methods Deprecated Methods Modifier and Type Method Description List<Injection>
filterInjections(Network network)
Scans all the expected injections of the scalable.void
filterInjections(Network network, List<Injection> injections, List<String> notFound)
Scans all the expected injections of the scalable.List<Injection>
filterInjections(Network network, List<String> notFound)
Scans all the expected injections of the scalable.static com.powsybl.iidm.modification.scalable.GeneratorScalable
gen(String id)
Deprecated.gen should be replaced by onGeneratordouble
initialValue(Network n)
Get the constant active power in MW injected at the network.List<Generator>
listGenerators(Network n)
Deprecated.listGenerators should be replaced by filterInjectionsvoid
listGenerators(Network n, List<Generator> generators, List<String> notFoundGenerators)
Deprecated.listGenerators should be replaced by filterInjectionsList<Generator>
listGenerators(Network n, List<String> notFoundGenerators)
Deprecated.listGenerators should be replaced by filterInjectionsdouble
maximumValue(Network n)
Get the maximal active power in MW.double
maximumValue(Network n, Scalable.ScalingConvention scalingConvention)
Get the maximal active power in MW with scaling convention.double
minimumValue(Network n)
Get the minimal active power in MW.double
minimumValue(Network n, Scalable.ScalingConvention scalingConvention)
Get the minimal active power in MW with scaling convention.static DanglingLineScalable
onDanglingLine(String id)
create DanglingLineScalable with id.static DanglingLineScalable
onDanglingLine(String id, double minValue, double maxValue)
create DanglingLineScalable with id, min and max power values for scaling.static DanglingLineScalable
onDanglingLine(String id, double minValue, double maxValue, Scalable.ScalingConvention scalingConvention)
create DanglingLineScalable with id, min and max power values for scaling and the scaling convention that will be used.static DanglingLineScalable
onDanglingLine(String id, Scalable.ScalingConvention scalingConvention)
create DanglingLineScalable with id and the scaling convention that will be used.static com.powsybl.iidm.modification.scalable.GeneratorScalable
onGenerator(String id)
create GeneratorScalable with idstatic com.powsybl.iidm.modification.scalable.GeneratorScalable
onGenerator(String id, double minValue, double maxValue)
create GeneratorScalable with id, min and max power values for scalingstatic com.powsybl.iidm.modification.scalable.LoadScalable
onLoad(String id)
create LoadScalable with idstatic com.powsybl.iidm.modification.scalable.LoadScalable
onLoad(String id, double minValue, double maxValue)
create LoadScalable with id, min and max power values for scalingstatic com.powsybl.iidm.modification.scalable.ProportionalScalable
proportional(float percentage, Scalable scalable)
static com.powsybl.iidm.modification.scalable.ProportionalScalable
proportional(float percentage1, Scalable scalable1, float percentage2, Scalable scalable2)
static com.powsybl.iidm.modification.scalable.ProportionalScalable
proportional(float percentage1, Scalable scalable1, float percentage2, Scalable scalable2, float percentage3, Scalable scalable3)
static com.powsybl.iidm.modification.scalable.ProportionalScalable
proportional(float percentage1, Scalable scalable1, float percentage2, Scalable scalable2, float percentage3, Scalable scalable3, float percentage4, Scalable scalable4)
static com.powsybl.iidm.modification.scalable.ProportionalScalable
proportional(float percentage1, Scalable scalable1, float percentage2, Scalable scalable2, float percentage3, Scalable scalable3, float percentage4, Scalable scalable4, float percentage5, Scalable scalable5)
static com.powsybl.iidm.modification.scalable.ProportionalScalable
proportional(List<Float> percentages, List<Scalable> scalables)
void
reset(Network n)
Set the constant active power to zero.static Scalable
scalable(String id)
static List<Scalable>
scalables(String... ids)
default double
scale(Network n, double asked)
double
scale(Network n, double asked, ScalingParameters parameters)
Scale the given network using Generator convention by default.static com.powsybl.iidm.modification.scalable.StackScalable
stack(Scalable... scalables)
static com.powsybl.iidm.modification.scalable.StackScalable
stack(String... ids)
static com.powsybl.iidm.modification.scalable.UpDownScalable
upDown(Scalable upScalable, Scalable downScalable)
-
-
-
Method Detail
-
initialValue
double initialValue(Network n)
Get the constant active power in MW injected at the network.
-
reset
void reset(Network n)
Set the constant active power to zero.
-
maximumValue
double maximumValue(Network n)
Get the maximal active power in MW. Uses Generator convention by default
-
minimumValue
double minimumValue(Network n)
Get the minimal active power in MW. Uses Generator convention by default
-
maximumValue
double maximumValue(Network n, Scalable.ScalingConvention scalingConvention)
Get the maximal active power in MW with scaling convention.- See Also:
Scalable.ScalingConvention
-
minimumValue
double minimumValue(Network n, Scalable.ScalingConvention scalingConvention)
Get the minimal active power in MW with scaling convention.- See Also:
Scalable.ScalingConvention
-
listGenerators
@Deprecated void listGenerators(Network n, List<Generator> generators, List<String> notFoundGenerators)
Deprecated.listGenerators should be replaced by filterInjections
-
listGenerators
@Deprecated List<Generator> listGenerators(Network n, List<String> notFoundGenerators)
Deprecated.listGenerators should be replaced by filterInjections
-
listGenerators
@Deprecated List<Generator> listGenerators(Network n)
Deprecated.listGenerators should be replaced by filterInjections
-
filterInjections
void filterInjections(Network network, List<Injection> injections, List<String> notFound)
Scans all the expected injections of the scalable. If the injection can be found in given network, it is added the the injections list. Otherwise, its identifier is added to the "notFound" list.- Parameters:
network
- networkinjections
- network injections used in the scalablenotFound
- expected injections not found in the network
-
filterInjections
List<Injection> filterInjections(Network network, List<String> notFound)
Scans all the expected injections of the scalable. If the injection can be found in given network, it is added the the injections list. Otherwise, its identifier is added to the "notFound" list.- Parameters:
network
- networknotFound
- expected injections not found in the network- Returns:
- network injections used in the scalable
-
filterInjections
List<Injection> filterInjections(Network network)
Scans all the expected injections of the scalable. If the injection can be found in given network, it is added the the injections list.- Parameters:
network
- network- Returns:
- network injections used in the scalable
-
scale
double scale(Network n, double asked, ScalingParameters parameters)
Scale the given network using Generator convention by default. The actual scaling value may be different to the one asked if the Scalable limit is reached.- Parameters:
n
- networkasked
- value asked to adjust the scalable active powerparameters
- specific parameters used to scale- Returns:
- the actual value of the scalable active power adjustment
-
scale
default double scale(Network n, double asked)
-
gen
@Deprecated static com.powsybl.iidm.modification.scalable.GeneratorScalable gen(String id)
Deprecated.gen should be replaced by onGenerator
-
onGenerator
static com.powsybl.iidm.modification.scalable.GeneratorScalable onGenerator(String id)
create GeneratorScalable with id
-
onGenerator
static com.powsybl.iidm.modification.scalable.GeneratorScalable onGenerator(String id, double minValue, double maxValue)
create GeneratorScalable with id, min and max power values for scaling
-
onLoad
static com.powsybl.iidm.modification.scalable.LoadScalable onLoad(String id)
create LoadScalable with id
-
onLoad
static com.powsybl.iidm.modification.scalable.LoadScalable onLoad(String id, double minValue, double maxValue)
create LoadScalable with id, min and max power values for scaling
-
onDanglingLine
static DanglingLineScalable onDanglingLine(String id)
create DanglingLineScalable with id. The generator scaling convention is used by default.
-
onDanglingLine
static DanglingLineScalable onDanglingLine(String id, Scalable.ScalingConvention scalingConvention)
create DanglingLineScalable with id and the scaling convention that will be used.
-
onDanglingLine
static DanglingLineScalable onDanglingLine(String id, double minValue, double maxValue)
create DanglingLineScalable with id, min and max power values for scaling. The generator scaling convention is used by default.
-
onDanglingLine
static DanglingLineScalable onDanglingLine(String id, double minValue, double maxValue, Scalable.ScalingConvention scalingConvention)
create DanglingLineScalable with id, min and max power values for scaling and the scaling convention that will be used.
-
proportional
static com.powsybl.iidm.modification.scalable.ProportionalScalable proportional(List<Float> percentages, List<Scalable> scalables)
-
proportional
static com.powsybl.iidm.modification.scalable.ProportionalScalable proportional(float percentage, Scalable scalable)
-
proportional
static com.powsybl.iidm.modification.scalable.ProportionalScalable proportional(float percentage1, Scalable scalable1, float percentage2, Scalable scalable2)
-
proportional
static com.powsybl.iidm.modification.scalable.ProportionalScalable proportional(float percentage1, Scalable scalable1, float percentage2, Scalable scalable2, float percentage3, Scalable scalable3)
-
proportional
static com.powsybl.iidm.modification.scalable.ProportionalScalable proportional(float percentage1, Scalable scalable1, float percentage2, Scalable scalable2, float percentage3, Scalable scalable3, float percentage4, Scalable scalable4)
-
proportional
static com.powsybl.iidm.modification.scalable.ProportionalScalable proportional(float percentage1, Scalable scalable1, float percentage2, Scalable scalable2, float percentage3, Scalable scalable3, float percentage4, Scalable scalable4, float percentage5, Scalable scalable5)
-
stack
static com.powsybl.iidm.modification.scalable.StackScalable stack(Scalable... scalables)
-
stack
static com.powsybl.iidm.modification.scalable.StackScalable stack(String... ids)
-
-