addEntries(factors, names, [resFiles], [eigens], [harms])
addEntries(factors, IDs, [resFiles], [eigens], [harms])
addEntries(factors, type, range)
addEntries(factors, range)
Add the specified loadsets. The input is given in the form of parallel arrays. The arrays must all be the same length. Each loadset is described by the corresponding value from each array (i.e. the third loadset is specified by the third ID, the third results file, etc). The loadsets can be specified in several ways, by name, by ID or by type and a range of names/IDs. In each case, additionally specifying the results file name/ID, eigenvalue ID and harmonic ID and structural/thermal status will clarify to LUSAS which loadset(s) are required. Alternatively, the value in the first array may contain an object, which requires no further clarification. This same principle applies to all functions that input multiple loadsets, and the examples below reflect this. Each input form is legal in each circumstance.
Examples
redim facArray(2) ' fill an array of factors
facArray(0) = 1.0
facArray(1) = 2.0
redim objArray(2) ' and another of lc objects
set objArray(0) = db.getLoadset(1, 1)
set objArray(1) = db.getLoadset(2, "C:\temp\model.mys")
redim idArray(2) ' and another of lc ids
idArray(0) = 1
idArray(1) = 2
redim resfileArray(2) ' and another of results files
resfileArray(0) = 1
resfileArray(1) = "C:\temp\model.mys"
envelope.addEntries(objArray)
combination.addEntries(facArray, objArray) ' 1.0*lc1, 2.0*lc2
combination.addEntries(facArray, idArray, resfileArray) ' 1.0*lc1, 2.0*lc2
db.deleteLoadsets("combination", "all")
db.deleteLoadsets("loadcase", "all", "structural") ' will not delete thermal loadcases
myArray = db.getLoadsets("1T10")
| loadsets | array | An array of loadset objects |
| names | array | An array of loadset names |
| IDs | array | An array of loadset IDs |
| resFiles | array | An array of results files - each may be given as a filename or ID |
| eigens | array | An array of loadset eigenvalue IDs |
| harms | array | An array of loadset harmonic IDs |
| type | string | A string to indicate the type of loadset: "Loadcase", "Combination", etc. If not given, all types are assumed |
| range | string | A string of the form "1T10I2", in this case representing the range from 1 to 10 in steps of 2, i.e. 1, 3, 5, 7 and 9 |
| Return value | Pointer to this object | Allows multiple function calls to be chained together |
Back to BasicCombination
Back to Overview