1212
1313
1414class spectrum_data (Operator ):
15- """Read spectral data from the result files contained in the streams or
16- data sources.
15+ """Read participation factors from mode file.
1716
1817 Parameters
1918 ----------
20- streams : StreamsContainer, optional
21- Result file container allowed to be kept open
22- to cache data.
2319 data_sources : DataSources
24- Result file path container, used if no
25- streams are set .
20+ Data_sources (must contain at least one mode
21+ file) .
2622
2723 Returns
2824 -------
2925 participation_factors : FieldsContainer
30- Fields container holding participation
26+ Fields container containing participation
3127 factors.
32- mode_coefficients : FieldsContainer
33- Fields container holding mode coefficients
34- (prs file).
35- damping_ratios : FieldsContainer
36- Fields container holding damping ratios (prs
37- file).
38- global_damping : FieldsContainer
39- Fields container holding for each spectrum:
40- global damping ratio, damping
41- stiffness coefficient & damping mass
42- coefficient (prs file).
43- missing_mass : FieldsContainer
44- Fields container holding for each spectrum:
45- missing mass mode (0: none, 1:
46- active), missing mass effect zpa (prs
47- file).
48- rigid_response : FieldsContainer
49- Fields container holding for each spectrum:
50- rigid response mode (0: none, 1:
51- gupta, 2: lindley), freq begin
52- (gupta) / zpa (lindley), freq end
53- (gupta) (prs file).
5428
5529 Examples
5630 --------
@@ -60,107 +34,47 @@ class spectrum_data(Operator):
6034 >>> op = dpf.operators.result.spectrum_data()
6135
6236 >>> # Make input connections
63- >>> my_streams = dpf.StreamsContainer()
64- >>> op.inputs.streams.connect(my_streams)
6537 >>> my_data_sources = dpf.DataSources()
6638 >>> op.inputs.data_sources.connect(my_data_sources)
6739
6840 >>> # Instantiate operator and connect inputs in one line
6941 >>> op = dpf.operators.result.spectrum_data(
70- ... streams=my_streams,
7142 ... data_sources=my_data_sources,
7243 ... )
7344
7445 >>> # Get output data
7546 >>> result_participation_factors = op.outputs.participation_factors()
76- >>> result_mode_coefficients = op.outputs.mode_coefficients()
77- >>> result_damping_ratios = op.outputs.damping_ratios()
78- >>> result_global_damping = op.outputs.global_damping()
79- >>> result_missing_mass = op.outputs.missing_mass()
80- >>> result_rigid_response = op.outputs.rigid_response()
8147 """
8248
83- def __init__ (self , streams = None , data_sources = None , config = None , server = None ):
49+ def __init__ (self , data_sources = None , config = None , server = None ):
8450 super ().__init__ (name = "spectrum_data" , config = config , server = server )
8551 self ._inputs = InputsSpectrumData (self )
8652 self ._outputs = OutputsSpectrumData (self )
87- if streams is not None :
88- self .inputs .streams .connect (streams )
8953 if data_sources is not None :
9054 self .inputs .data_sources .connect (data_sources )
9155
9256 @staticmethod
9357 def _spec ():
94- description = """Read spectral data from the result files contained in the streams or
95- data sources."""
58+ description = """Read participation factors from mode file."""
9659 spec = Specification (
9760 description = description ,
9861 map_input_pin_spec = {
99- 3 : PinSpecification (
100- name = "streams" ,
101- type_names = ["streams_container" ],
102- optional = True ,
103- document = """Result file container allowed to be kept open
104- to cache data.""" ,
105- ),
10662 4 : PinSpecification (
10763 name = "data_sources" ,
10864 type_names = ["data_sources" ],
10965 optional = False ,
110- document = """Result file path container, used if no
111- streams are set .""" ,
66+ document = """Data_sources (must contain at least one mode
67+ file) .""" ,
11268 ),
11369 },
11470 map_output_pin_spec = {
11571 0 : PinSpecification (
11672 name = "participation_factors" ,
11773 type_names = ["fields_container" ],
11874 optional = False ,
119- document = """Fields container holding participation
75+ document = """Fields container containing participation
12076 factors.""" ,
12177 ),
122- 1 : PinSpecification (
123- name = "mode_coefficients" ,
124- type_names = ["fields_container" ],
125- optional = False ,
126- document = """Fields container holding mode coefficients
127- (prs file).""" ,
128- ),
129- 2 : PinSpecification (
130- name = "damping_ratios" ,
131- type_names = ["fields_container" ],
132- optional = False ,
133- document = """Fields container holding damping ratios (prs
134- file).""" ,
135- ),
136- 3 : PinSpecification (
137- name = "global_damping" ,
138- type_names = ["fields_container" ],
139- optional = False ,
140- document = """Fields container holding for each spectrum:
141- global damping ratio, damping
142- stiffness coefficient & damping mass
143- coefficient (prs file).""" ,
144- ),
145- 4 : PinSpecification (
146- name = "missing_mass" ,
147- type_names = ["fields_container" ],
148- optional = False ,
149- document = """Fields container holding for each spectrum:
150- missing mass mode (0: none, 1:
151- active), missing mass effect zpa (prs
152- file).""" ,
153- ),
154- 5 : PinSpecification (
155- name = "rigid_response" ,
156- type_names = ["fields_container" ],
157- optional = False ,
158- document = """Fields container holding for each spectrum:
159- rigid response mode (0: none, 1:
160- gupta, 2: lindley), freq begin
161- (gupta) / zpa (lindley), freq end
162- (gupta) (prs file).""" ,
163- ),
16478 },
16579 )
16680 return spec
@@ -210,46 +124,21 @@ class InputsSpectrumData(_Inputs):
210124 --------
211125 >>> from ansys.dpf import core as dpf
212126 >>> op = dpf.operators.result.spectrum_data()
213- >>> my_streams = dpf.StreamsContainer()
214- >>> op.inputs.streams.connect(my_streams)
215127 >>> my_data_sources = dpf.DataSources()
216128 >>> op.inputs.data_sources.connect(my_data_sources)
217129 """
218130
219131 def __init__ (self , op : Operator ):
220132 super ().__init__ (spectrum_data ._spec ().inputs , op )
221- self ._streams = Input (spectrum_data ._spec ().input_pin (3 ), 3 , op , - 1 )
222- self ._inputs .append (self ._streams )
223133 self ._data_sources = Input (spectrum_data ._spec ().input_pin (4 ), 4 , op , - 1 )
224134 self ._inputs .append (self ._data_sources )
225135
226- @property
227- def streams (self ):
228- """Allows to connect streams input to the operator.
229-
230- Result file container allowed to be kept open
231- to cache data.
232-
233- Parameters
234- ----------
235- my_streams : StreamsContainer
236-
237- Examples
238- --------
239- >>> from ansys.dpf import core as dpf
240- >>> op = dpf.operators.result.spectrum_data()
241- >>> op.inputs.streams.connect(my_streams)
242- >>> # or
243- >>> op.inputs.streams(my_streams)
244- """
245- return self ._streams
246-
247136 @property
248137 def data_sources (self ):
249138 """Allows to connect data_sources input to the operator.
250139
251- Result file path container, used if no
252- streams are set .
140+ Data_sources (must contain at least one mode
141+ file) .
253142
254143 Parameters
255144 ----------
@@ -276,27 +165,12 @@ class OutputsSpectrumData(_Outputs):
276165 >>> op = dpf.operators.result.spectrum_data()
277166 >>> # Connect inputs : op.inputs. ...
278167 >>> result_participation_factors = op.outputs.participation_factors()
279- >>> result_mode_coefficients = op.outputs.mode_coefficients()
280- >>> result_damping_ratios = op.outputs.damping_ratios()
281- >>> result_global_damping = op.outputs.global_damping()
282- >>> result_missing_mass = op.outputs.missing_mass()
283- >>> result_rigid_response = op.outputs.rigid_response()
284168 """
285169
286170 def __init__ (self , op : Operator ):
287171 super ().__init__ (spectrum_data ._spec ().outputs , op )
288172 self ._participation_factors = Output (spectrum_data ._spec ().output_pin (0 ), 0 , op )
289173 self ._outputs .append (self ._participation_factors )
290- self ._mode_coefficients = Output (spectrum_data ._spec ().output_pin (1 ), 1 , op )
291- self ._outputs .append (self ._mode_coefficients )
292- self ._damping_ratios = Output (spectrum_data ._spec ().output_pin (2 ), 2 , op )
293- self ._outputs .append (self ._damping_ratios )
294- self ._global_damping = Output (spectrum_data ._spec ().output_pin (3 ), 3 , op )
295- self ._outputs .append (self ._global_damping )
296- self ._missing_mass = Output (spectrum_data ._spec ().output_pin (4 ), 4 , op )
297- self ._outputs .append (self ._missing_mass )
298- self ._rigid_response = Output (spectrum_data ._spec ().output_pin (5 ), 5 , op )
299- self ._outputs .append (self ._rigid_response )
300174
301175 @property
302176 def participation_factors (self ):
@@ -314,88 +188,3 @@ def participation_factors(self):
314188 >>> result_participation_factors = op.outputs.participation_factors()
315189 """ # noqa: E501
316190 return self ._participation_factors
317-
318- @property
319- def mode_coefficients (self ):
320- """Allows to get mode_coefficients output of the operator
321-
322- Returns
323- ----------
324- my_mode_coefficients : FieldsContainer
325-
326- Examples
327- --------
328- >>> from ansys.dpf import core as dpf
329- >>> op = dpf.operators.result.spectrum_data()
330- >>> # Connect inputs : op.inputs. ...
331- >>> result_mode_coefficients = op.outputs.mode_coefficients()
332- """ # noqa: E501
333- return self ._mode_coefficients
334-
335- @property
336- def damping_ratios (self ):
337- """Allows to get damping_ratios output of the operator
338-
339- Returns
340- ----------
341- my_damping_ratios : FieldsContainer
342-
343- Examples
344- --------
345- >>> from ansys.dpf import core as dpf
346- >>> op = dpf.operators.result.spectrum_data()
347- >>> # Connect inputs : op.inputs. ...
348- >>> result_damping_ratios = op.outputs.damping_ratios()
349- """ # noqa: E501
350- return self ._damping_ratios
351-
352- @property
353- def global_damping (self ):
354- """Allows to get global_damping output of the operator
355-
356- Returns
357- ----------
358- my_global_damping : FieldsContainer
359-
360- Examples
361- --------
362- >>> from ansys.dpf import core as dpf
363- >>> op = dpf.operators.result.spectrum_data()
364- >>> # Connect inputs : op.inputs. ...
365- >>> result_global_damping = op.outputs.global_damping()
366- """ # noqa: E501
367- return self ._global_damping
368-
369- @property
370- def missing_mass (self ):
371- """Allows to get missing_mass output of the operator
372-
373- Returns
374- ----------
375- my_missing_mass : FieldsContainer
376-
377- Examples
378- --------
379- >>> from ansys.dpf import core as dpf
380- >>> op = dpf.operators.result.spectrum_data()
381- >>> # Connect inputs : op.inputs. ...
382- >>> result_missing_mass = op.outputs.missing_mass()
383- """ # noqa: E501
384- return self ._missing_mass
385-
386- @property
387- def rigid_response (self ):
388- """Allows to get rigid_response output of the operator
389-
390- Returns
391- ----------
392- my_rigid_response : FieldsContainer
393-
394- Examples
395- --------
396- >>> from ansys.dpf import core as dpf
397- >>> op = dpf.operators.result.spectrum_data()
398- >>> # Connect inputs : op.inputs. ...
399- >>> result_rigid_response = op.outputs.rigid_response()
400- """ # noqa: E501
401- return self ._rigid_response
0 commit comments