ResponseSpectrum2D, ResponseSpectrum3D

Create a response spectrum 2D or 3D dataset. A response spectrum analysis is a modal-based method for estimating the structural response to a transient, nondeterministic event. Typical applications are designing against earthquakes and shocks.


	The ResponseSpectrum2D and ResponseSpectrum3D datasets require a license for the Structural Mechanics Module.

Syntax

model.result().dataset().create(<dtag>,"ResponseSpectrum2D");

model.result().dataset().create(<dtag>,"ResponseSpectrum3D");

model.result().dataset(<dtag>).set(property, <value>);

Description

model.result().dataset().create(<dtag>,"ResponseSpectrum2D") creates a 2D response spectrum dataset feature named <dtag>.

model.result().dataset().create(<dtag>,"ResponseSpectrum3D") creates a 3D response spectrum dataset feature named <dtag>.

The input to a response spectrum is the results from an eigenfrequency computation.

The following properties are available for ResponseSpectrum2D and ResponseSpectrum3D:

Table 7-121: Valid Property/Value Pairs for Response Spectrum2D and Response Spectrum3D Datasets
name	Value	Default	Description
abscouplingterms	Boolean	false	Use absolute value for coupling terms, when modecomb is cqc, grouping, or tenpercent.
abscouplingtermsdoublesum	Boolean	false	Use absolute value for coupling terms (NRC RG 1.92 Rev. 1), when modecomb is doublesum.
augmentwithrigidresponse	Boolean	false	Augment with rigid response, when spatialcomb is cqc3 or srss3 (3D only).
data	none \| dataset name	First compatible dataset	The eigenvalue dataset this feature refers to.
durationtime	nonnegative scalar	0	The time of duration (in seconds) when modecomb is doublesum.
freqlimitperiodic	nonnegative scalar	0	Frequency limit for purely periodic modes (when rigidmodes is not none).
freqlimitrigid	nonnegative scalar	0	Frequency limit for purely rigid modes (when rigidmodes is gupta).
masscorrectiongupta	missingmass \| none	none	Mass correction when rigidmodes is gupta: none or missing mass method.
masscorrectionlindleyyow	staticzpa \| missingmass \| none	none	Mass correction when rigidmodes is lindleyyow: none, missing mass method, or static ZPA method.
modecomb	cqc \| abssum \| srss \| doublesum \| grouping \| tenpercent	cqc	Mode combination: CQC (Der Kiureghian), absolute value sun, SRSS, double sum (Rosenblueth), grouping method, or ten percent method. Available when spatialcomb is srss or percent.
primaxisrotation	angle	0[deg]	Primary axis rotation (3D only).
primhorizspectrum	none \| function name	none	Horizontal spectrum function in 2D; primary horizontal spectrum function in 3D.
reldamp	0–1	0.05	Damping ratio when modecomb is cqc or doublesum.
rigidmodes	lindleyyow \| gupta \| none	none	Rigid modes.
sechorizscale	nonnegative scalar	0.5	Secondary horizontal spectrum scale factor, when spatialcomb is cqc3 or srss3 (3D only).
sechorizspectrum	none \| function name	none	Secondary horizontal spectrum function (3D only).
spatialcomb	srss \| percent \| cqc3 \| srss3	srss	Spatial combination: SRSS, percent method, CQC3 (3D only), or SRSS3 (3D only).
spectrumfunof	frequency \| periodtime	frequency	If the spectrum depends on frequency or period time.
spectrumtype	pseudoacc \| displacement \| pseudovel	pseudoacc	Spectrum type: pseudoacceleration, displacement, or pseudovelocity spectrum.
vertspectrum	none \| function name	none	Vertical spectrum function.
wgtsmallresponse	0–1 (0-100%)	40[%]	Weight factor for smaller response (when spatialcomb is percent).
zeroperiodaccfreq	nonnegative scalar	0	Zero period acceleration frequency (when rigidmodes is not none). Available when spatialcomb is srss or percent.