imat_result/get


Purpose

Get one or more attributes of an imat_result object.

Syntax

v=get(r,'Attrib')
v=get(r,'Attrib1','Attrib2',...)
v=get(r)

Description

When applied to an imat_result object s, the GET function returns the values of selected attributes of r. The available attributes are listed here. Attribute names are not case sensitive.

If only a single attribute is requested, then the value of that attribute is returned, or printed if no output argument is supplied. Numeric attributes are returned in a numeric array with the same dimensions as r. String-valued attributes (including list attributes) are returned in a string variable (if s is a single result) or a cell array of strings with the same dimensions as r (if r contains more than one result). The Data attribute returns a cell array containing the individual result data objects. If any of the results has a smaller number of data values, that column will be padded with NaN values.

If more than one attribute is specified, then the output argument will be a scalar structure variable with field names equal to the requested attributes. The value of each field will be as described above. If no output argument is supplied, the resulting structure will be printed on the standard output.

If no attributes are specified, then the values of all attributes will be returned as described above.

An alternative to the get function is the syntax r.attrib.

Examples

>> setunits('si')
Units set to SI

>> r=readunv(fullfile('..','data','ideas_results_modes_statics.unv'),'asresult',2414)
No units in universal file, assuming SI
Read 17x1 result
r =
17x1 IMAT_RESULT
Row  Name                                 DataLocation               ModelType   ResultType
---  -----------------------------------  -------------------------  ----------  ------------------------
  1  B.C. 1,NORMAL_MODE 1,DISPLACEMENT_   Data at nodes              Structural  Displacement
  2  B.C. 1,NORMAL_MODE 2,DISPLACEMENT_   Data at nodes              Structural  Displacement
  3  B.C. 1,NORMAL_MODE 3,DISPLACEMENT_   Data at nodes              Structural  Displacement
  4  B.C. 1,NORMAL_MODE 4,DISPLACEMENT_   Data at nodes              Structural  Displacement
  5  B.C. 1,NORMAL_MODE 5,DISPLACEMENT_   Data at nodes              Structural  Displacement
  6  B.C. 1,NORMAL_MODE 6,DISPLACEMENT_   Data at nodes              Structural  Displacement
  7  B.C. 1,NORMAL_MODE 7,DISPLACEMENT_   Data at nodes              Structural  Displacement
  8  B.C. 1,NORMAL_MODE 8,DISPLACEMENT_   Data at nodes              Structural  Displacement
  9  B.C. 1,NORMAL_MODE 9,DISPLACEMENT_   Data at nodes              Structural  Displacement
 10  B.C. 1,NORMAL_MODE 10,DISPLACEMEN_   Data at nodes              Structural  Displacement
 11  B.C. 2,DISPLACEMENT_11,LOAD SET 1    Data at nodes              Structural  Displacement
 12  B.C. 2,REACTION FORCE_12,LOAD SET    Data at nodes              Structural  Reaction Force
 13  B.C. 2,STRESS_13,LOAD SET 1          Data at nodes on elements  Structural  Stress
 14  B.C. 2,STRAIN_14,LOAD SET 1          Data at nodes on elements  Structural  Strain
 15  B.C. 2,EL STRESS RES_15,LOAD SET 1   Data at nodes on elements  Structural  Element Stress Resultant
 16  B.C. 2,STRAIN ENERGY_16,LOAD SET 1   Data on elements           Structural  Strain Energy
 17  B.C. 2,ELEMENT FORCE_17,LOAD SET 1   Data at nodes on elements  Structural  Element Force

>> get(r(1))
                   Name: ' B.C. 1,NORMAL_MODE 1,DISPLACEMENT_1'
                IDLine1: ''
                IDLine2: 'MODEL_SOLUTION_SOLVE'
                IDLine3: 'Mode Shape 1  Frequency<Hz> =  13.09024'
                IDLine4: 'Error =  4.5E-12 %  Analysis time was     24-Mar-05       15:41:47'
                IDLine5: 'Solset 1 - NORMAL MODES  M orthog= 1.9E-16  K orthog= 6.5E-14'
              ModelType: 'Structural'
           AnalysisType: 'Normal mode'
             ResultType: 'Displacement'
           DataLocation: 'Data at nodes'
           NumberValues: 216
              ExpLength: 1
               ExpForce: 0
         ExpTemperature: 0
                ExpTime: 0
            DesignSetID: -10
        IterationNumber: 0
          SolutionSetID: 1
      BoundaryCondition: 1
                LoadSet: 0
             ModeNumber: 1
         TimeStepNumber: 0
        FrequencyNumber: 0
         CreationOption: 2
         NumberRetained: 0
                   Time: 0
              Frequency: 13.0902
             Eigenvalue: 82.2482
         EigenvalueReal: 82.2482
         EigenvalueImag: 0
              ModalMass: 0
          ModalMassReal: 0
          ModalMassImag: 0
         ViscousDamping: 0
      HystereticDamping: 0
                 ModalA: 0
             ModalAReal: 0
             ModalAImag: 0
                 ModalB: 0
             ModalBReal: 0
             ModalBImag: 0
              Stiffness: 0
          StiffnessReal: 0
          StiffnessImag: 0
          EffectiveMass: [6x1 double]
    ParticipationFactor: [6x1 double]
                   data: [1x1 imat_result_dan]

>>

See Also

imat_result, imat_result/set