*Para

<< Click to Display Table of Contents >>

Navigation:  Flexcom > Data Inputs > $HISTOGRAM >

*Para

Previous pageNext page

Purpose

To request response histograms of restoring force, stress, reaction, or relative rotation.

Theory

Refer to Histogram Overview for further information on this feature.

Keyword Format

A block of 2-3 lines for each histogram request. The format of the inputs varies with parameter type, as follows.

Lines for a response histogram of restoring force:

TYPE=1

Element (Number or Label), Local Node, Variable

[Scale]

Lines for a response histogram of stress:

TYPE=1

Element (Number or Label), Local Node, Variable, Stress Point

[Scale][,Do][,Di][,A][,Iyy]

Lines for a response histogram of reaction at a restrained node:

TYPE=2

Node (Number or Label), DOF

[Scale]

Lines for a response histogram of relative rotation between the two nodes of an element:

TYPE=3

Element (Number or Label)

If you specify a node/element label rather than a number, it must be enclosed in {} brackets. Scale defaults to 1. Do, Di, A and Iyy default to the corresponding values used in the first Flexcom random sea analysis specified in the seastate file.

The following Variable values are valid when requesting a force or stress histogram.

1.        Axial Force

2.        Local-y Shear

3.        Local-z Shear

4.        Torque

5.        Local-y Moment

6.        Local-z Moment

7.        Effective Tension

8.        von Mises Stress

9.        Bending Stress

10.        Axial Stress

11.        Combined Stress

For Variable values of 8, 9 or 11 (von Mises, bending or combined stress), a Stress Point input is appropriate, where Stress Point is an integer value specifying a point on the cross-section. If omitted, Stress Point defaults to the point of maximum stress on the cross-section.

Table Input

Parameters - Force

Input:

Description

Element:

The element (number or label) for which the restoring force histogram is being requested. If you specify an element label rather than an element number, it must be enclosed in {} brackets.

Local Node:

This option allows you to choose between three locations on the specified element. First Node refers to the first specified node of the element, Last Node is the second specified node, and Midpoint is half-way between the two.

Variable:

This list allows you to select a relevant output parameter. The entries are largely self-explanatory. See Note (a).

Scale Factor:

This value is used to transform data in the Flexcom units to appropriate units for the Histogram output. This input is optional, and defaults to 1.

Parameters - Stress

Input:

Description

Element:

The element (number or label) for which the restoring force histogram is being requested. If you specify an element label rather than an element number, it must be enclosed in {} brackets.

Local Node:

This option allows you to choose between three locations on the specified element. First Node refers to the first specified node of the element, Last Node is the second specified node, and Midpoint is half-way between the two.

Variable:

This list allows you to select a relevant output parameter. The entries are largely self-explanatory. See Note (a).

De:

The external diameter of the element for which stresses are required. See Note (b).

Di:

The internal diameter of the element for which stresses are required. See Note (b).

A:

The effective cross-sectional area of the element for which stresses are required. See Note (b).

Iyy:

The second moment of area about the local y-axis of the element for which stresses are required. See Note (b).

Stress Point:

This gives a choice of location on the cross-section for which stresses are to be generated. Valid values are between 1 and 8 inclusive. This corresponds to an angle measured in degrees anti-clockwise from the local element cross-section y-axis where 1 = 0°, 2 = 45°, 3 = 90°, etc.

Scale Factor:

This value is used to transform data in the Flexcom units to appropriate units for the Histogram output. This input is optional, and defaults to 1.

Parameters - Reaction

Input:

Description

Node:

The restrained node (number or label) for which the reaction histogram is being requested. If you specify a node label rather than a node number, it must be enclosed in {} brackets. See Note (c).

DOF:

The global degree of freedom (DOF) of the reaction force. Specify a value of 1 for the global X-direction, 2, for global Y-direction, and 3 for the global Z-direction. DOFs 4, 5, and 6 refer to the components of the rotation vector at the node.

Scale Factor:

This value is used to transform data in the Flexcom units to appropriate units for the Histogram output. This input is optional, and defaults to 1.

Parameters - Rotation

Input:

Description

Element:

The element (number or label) for which the rotation histogram is being requested. If you specify an element label rather than an element number, it must be enclosed in {} brackets.

DOF:

The degree of freedom (DOF) on which the rotation is based. Only values of 4, 5, or 6 are valid.

Notes

(a)Refer to Force and Stress Outputs for a detailed discussion of the various output parameters.

(b)The De, Di, A and Iyy entries are optional. Where a particular value is not specified, then Histogram retrieves an appropriate value from the first Flexcom analysis in the list that you input using Flexcom Files.

(c)Histogram will generate an error if you request a reaction histogram for a node and DOF which are unrestrained.