CombineSolution
Operate on solutions using concatenation, convert outer to inner solutions, summation, weighted summation, general summation, or remove solutions.
Syntax
model.sol(sname).create(fname,"CombineSolution")
model.sol(sname).feature(fname).set("soloper","remsol")
Description
This feature manipulates solutions via concatenation, summation or removal. The concatenation can, for example, take two time-dependent solutions solver over different time spans and combine them into a single time-dependent solution including all times from both solutions. You can also remove solutions. Stationary solutions are not possible to use. The following properties are accepted:
Table 6-29: Valid CombineSolution Properties.
Property
Value
Default
Description
addinterpparam
boolean
true
Add interpolated solution at intersection points for continuous parameter intervals.
addinterpt
boolean
true
Add interpolated solution at intersection times.
clearscrsol
boolean
false
Clear the source solution when creating a weighted summation or removing solutions.
concatmethod
firstprecedence | includeall
firstprecedence
For soloper set to concatenation, make first solution have precedence or include all solutions.
conjugatepairconsecutivesort
boolean
true
Use a conjugate-pair consecutive sort of eigenvalues regardless of the sorting method.
cssol
current | any available solution
current
The solution to sum, when soloper is set to summation.
cssol1
current | any available solution
current
The first solution to concatenate, when soloper is set to concatenation.
cssol2
current | any available solution
current
The second solution to sum, when soloper is set to concatenation.
cssolouter
current | any available solution
current
The source solution when soloper is set to convertouter.
cssolwghtsum
current | any available solution
current
The solution to use for a weighted solution, when soloper is set to wgtsum.
excludeorinclude
explicit | implicit
explicit
Exclude or include selected solutions when soloper is set to remsol.
excmethod
explicit | implicit
explicit
Exclude method: explicit or implicit selection.
incmethod
explicit | implicit
explicit
Include method: explicit or implicit selection.
interpandsort
auto | manual
auto
Automatic or manual interpolation and sort settings if soloper is set to concatenation.
keeplog
true | false
false
Keep warnings in stored log.
listsolnum
vector of integers
{1}
Indices to solutions to use as linearization points when solnum = from_list.
manualoutersolnumcssol1
vector of positive integers
{1}
Identifies the outer solutions to include when outersolnumcssol1 = manual.
manualoutersolnumcssol2
vector of positive integers
{1}
Identifies the outer solutions to include when outersolnumcssol2 = manual.
manualoutersolnumpssol
vector of positive integers
{1}
Identifies the outer solutions to include when outersolnumpssol = manual.
manualpname1
String array
new String[]{}
Name of the outer parameters from the parametric sweep solution when outerparammethod1 is manual.
manualpname2
String array
new String[]{}
Name of the outer parameters from the parametric sweep solution when outerparammethod2 is manual.
manualplist1
String array
 
Value of the outer parameters from the parametric sweep solution when outerparammethod1 is manual.
manualplist2
String array
 
Value of the outer parameters from the parametric sweep solution when outerparammethod2 is manual.
manualpunit1
String array
new String[]{}
Unit of the outer parameters from the parametric sweep solution when outerparammethod1 is manual.
manualpunit2
String array
new String[]{}
Unit of the outer parameters from the parametric sweep solution when outerparammethod2 is manual.
manualsolnum
vector of positive integers
{1}
Identifies the solutions used when solnum = manual.
outerlistsolnumcssol1
any available parametric store solution
 
Identifies the outer solutions to include when outersolnumcssol1 = from_list.
outerlistsolnumcssol2
any available parametric store solution
 
Identifies the outer solutions to include when outersolnumcssol2 = from_list.
outerlistsolnumpssol
any available parametric store solution
 
Identifies the outer solutions to include when outersolnumpssol = from_list.
outerparammethod1
auto | manual
auto
How to define the outer parameter values for the simple solution when concatenating with a parametric sweep solution. Available when cssol1 is a simple solution.
outerparammethod2
auto | manual
auto
How to define the outer parameter values for the single solution when concatenating with a parametric sweep solution. Available when cssol2 is a simple solution.
outersolnumcssol1
all | from_list | manual
all
Selection of outer solutions to include when cssol1 is a parametric sweep solution: All, from list, or manual.
outersolnumcssol2
all | from_list | manual
all
Selection of outer solutions to include when cssol2 is a parametric sweep solution: All, from list, or manual.
outersolnumpssol
all | from_list | manual
all
Selection of outer solutions to include when pssol is a parametric sweep solution: All, from list, or manual.
pssol
current | any available solution
current
The parametric sweep solution to concatenate, when soloper is set to convertouter.
removesol
current | any available solution
current
The solution to remove from, when soloper is set to remsol.
remsolfromexprexc
String
 
Logical expression for solutions to exclude, when soloper is set to remsol.
remsolfromexprinc
String
 
Logical expression for solutions to include, when soloper is set to remsol.
solnum
all | from_list | manual
all
Selection of solutions to exclude or include, when soloper is set to remsol: All, from listsolnum, or from manualsolnum.
soloper
concatenation | convertouter | summation | wgtsum | gensum | remsol
concatenation
Combine solutions using concatenation, convert outer to inner solutions, summation, weighted summation, general summation, or remove solutions.
solutiontype
parametric | time | eigenvalue
parametric
Specify a solution type if interpandsort is set to manual.
sortdiscontinparams
boolean
true
Sort discontinuous single-parameter values.
sorteigexpression
String
 
The expressions used to sort the eigenvalues or eigenfrequencies. Specified using setIndex().
sorteigmethod
predefined | user
predefined
Use a predefined or user defined sorting method, if sorteigvalues is set to true.
sorteigorder
ascend | descend
ascend
Sort eigenvalues in ascending or descending order, if sorteigvalues is set to true.
sorteigprimarily
realpart | imagpart | realpartmagnitude | imagpartmagnitude | absval
See description
Primary sorting expression, if sorteigmethod is set to predefined. For eigenvalues, the default is realpart; for eigenfrequencies, the default is imagpart.
sorteigsecondarily
realpart | imagpart | realpartmagnitude | imagpartmagnitude | absval
See description
Secondary sorting expression, if sorteigmethod is set to predefined. For eigenvalues, the default is imagpart; for eigenfrequencies, the default is imagpartmagnitude.
sorteigvalues
boolean
true
Sort eigenvalues.
sortontransformedeig
true | false
true
Sort based on transformed eigenvalues, if sorteigmethod is set to predefined.
weightsmethod
oneexpr | listexpr
oneexpr
Use one expression or a list of expressions for the weighted summation.
weightoneexpr
String
1
A single expression as weight for the summation (when weightsmethod is set to oneexpr).
When weightsmethod is set to listexpr, use setIndex with the properties wsolnum. weightlistexpr, and weightlistexpractive to specify the index (solution number), lists of weights, and active flags, respectively, for the case with a list of weights for a weighted summation. See setIndex(), and Methods Associated to Set, SetIndex, and the Various Get Methods for more information.