itasca.structure.linerarray

Array interface for liner elements.

Functions

itasca.structure.linerarray.area() → array float{liner}.: Get a Numpy array of surface area of the liner elements.

itasca.structure.linerarray.beta() → array float{liner}.: Get a Numpy array of liner system beta angle. This is defined as the angle between the element local system x-axis and the material system x-axis. In radians measured counter-clockwise from the element local x-axis.

itasca.structure.linerarray.component_id() → array int{liner}.: Get a NumPy array of the ID of liner component id.

itasca.structure.linerarray.density() → array double{liner}.: Get a NumPy array of the density of liner elements.

itasca.structure.linerarray.depth_factor() → array float{liner}.: Get a Numpy array of the depth factor at which stresses have been recovered. The depth equals Ft/2 where t is the liner element thickness. F values equal to +1.0 or -1.0 correspond to the outer/inner liner surface. The outer surface is defined by the positive z-direction of the local liner element system. F values of 0.0 corresponds to the liner mid-surface. The depth factor can be modified with the \(structure liner recover stress\) command.

itasca.structure.linerarray.element_type() → array str{liner}.: Get a Numpy array of the name of the finite-element type used by the liner elements. The possible types for liner elements are ‘cst’, ‘csth’, ‘dkt’, ‘dkt-cst’, and ‘dkt-csth’.

itasca.structure.linerarray.embedded() → array bool{liner}.: Get a Numpy array of the embedded flag. True denotes that the liner element is embedded.

itasca.structure.linerarray.extra(slot: int) → array float{liner} or float{liner,3}.: Get the liner extra data in the given slot as an array. Extra variables accessed by array must be of type float or vec.

itasca.structure.linerarray.force_nodal() → array float{liner,6,3}.: Get a Numpy array of the generalized nodal force acting on the liner at each node. The translational and rotational components of node 1 are given first.

itasca.structure.linerarray.id() → array int{liner}.: Get a NumPy array of the ID of liner element id.

itasca.structure.linerarray.in_group(group_name: str, slot=1) → array bool{liner}.: Return liner group membership as a Boolean array.

itasca.structure.linerarray.local_system() → array double{liner,3,3}.: Get a NumPy array of the local coordinate system of liner elements.

itasca.structure.linerarray.mark() → array bool{liner}.: Get a NumPy array of the mark flag of liner elements.

itasca.structure.linerarray.normal_dir() → array float{liner,3,3}.: Get a Numpy array of the direction (unit vector in global system) in which the liner elements are being loaded by the normal coupling spring at each node.

itasca.structure.linerarray.normal_disp() → array float{liner}.: Get a Numpy array of the displacement magnitude in the normal coupling spring at each node. The coupling spring lies in the tangent plane of the liner surface. The direction in which force is acting is given by \(normal_dir\) method.

itasca.structure.linerarray.normal_stiffness() → array float{liner,2}.: Get a Numpy array of the normal coupling spring stiffness of the liner element for each side of the liner.

itasca.structure.linerarray.normal_strength() → array float{liner,2}.: Get a Numpy array of the normal coupling spring tensile strength for each side of the liner element.

itasca.structure.linerarray.normal_stress() → array float{liner,3}.: Get a Numpy array of the stress magnitude in the normal coupling spring at each node. The coupling spring lies in the tangent plane of the liner surface. The direction in which force is acting is given by \(normal_dir\) method.

itasca.structure.linerarray.poisson() → array float{liner}.: Get a Numpy array of the Poisson’s ratio of the elements.

itasca.structure.linerarray.pos() → array vec3{liner}.: Get a NumPy array of the current position of liner elements.

itasca.structure.linerarray.pressure() → array float{liner}.: Get a Numpy array of the uniform pressure acting on the liner elements. A positive value acts in the z-direction of the element local system.

itasca.structure.linerarray.prop_anis() → (membrane: tuple of float, bending: tuple of float).: Get the anisotropic material properties. Material-stiffness coefficients c’11, c’12, c’13, c’22, c’23, c’33 are returned for both the membrane and bending stiffnesses in that order. If the element does not have anisotropic properties, zeros are returned.

itasca.structure.linerarray.prop_ortho() → (membrane: tuple of float, bending: tuple of float).: Get the orthotropic material properties. Material-stiffness coefficients c’11, c’12, c’13, c’22, c’23, c’33 are returned for both the membrane and bending stiffnesses in that order. If the element does not have orthotropic properties, zeros are returned.

itasca.structure.linerarray.prop_type() → array str{liner}.: Get a Numpy array of the material property type. Possible return values are ‘isotropic’, ‘orthotripc’, and ‘anisotropic’.

itasca.structure.linerarray.resultant(location: int) → length 8 tuple of array float{liner}.: Get a Numpy array of stress resultants last calculated for the element at the index \(location\). A \(location\) value of 0 gives the resultant at the element centroid; \(location\) values 1, 2 and 3 give the resultant at the nodes. The components in the return value are: Mx, My, Mxy, Nx, Ny, Nxy, Qx and Qy. Note that stress resultants must be calculated with the \(structure liner recover\) command. See also the \(resultant_valid\) method.

itasca.structure.linerarray.resultant_valid() → array bool{liner}.: Get a Numpy array of of the stress resultant validity flag. True indicates that the stress resultant values are valid. False indicates that resultants have not been calculated or that there has been a change since they were last calculated that would invalidate the results.

itasca.structure.linerarray.set_density(array double{liner}) → None.: Set the density of liner elements.

itasca.structure.linerarray.set_extra(slot: int, data: array float{liner} or float{liner, 3}) → None.: Set the liner extra data in the given slot with an array. Extra variables set by array must be of type float or vec.

itasca.structure.linerarray.set_group(membership: array bool{liner}, group_name: str, slot=1) → None.: Set liner group from an array. Where membership True set the corresponding liner to be a member of group group_name in the given slot.

itasca.structure.linerarray.set_mark(array bool{liner}) → None.: Set the mark flag of liner elements.

itasca.structure.linerarray.set_normal_strength(array float{liner}) → None.: Set the normal coupling spring tensile strength for each side of the liner element.

itasca.structure.linerarray.set_poisson(array float{liner}) → None.: Set the Poisson’s ratio of the elements.

itasca.structure.linerarray.set_pressure(array float{liner}) → None.: Set the uniform pressure acting on the liner elements. A positive value acts in the z-direction of the element local system.

itasca.structure.linerarray.set_shear_friction(array float{liner, 2}) → None.: Set the shear coupling spring friction angle for each side of the liner elements.

itasca.structure.linerarray.set_slide(array bool{liner}) → None.: Set the large-strain sliding flag. A true value denotes that the large-strain sliding is on.

itasca.structure.linerarray.set_slide_tol(array float{liner}) → None.: Set the (shear) coupling spring slide tolerance of the liner elements.

itasca.structure.linerarray.set_thermal_expansion(array double{liner}) → None.: Set the thermal expansion coefficient of liner elements.

itasca.structure.linerarray.set_thickness(array float{liner}) → None.: Set the element thickness.

itasca.structure.linerarray.set_young(array float{liner}) → None.: Set the Youngs modulus of the elements.

itasca.structure.linerarray.shear_cohesion() → array float{liner,2}.: Get a Numpy array of the shear coupling spring cohesion for each side of the liner element.

itasca.structure.linerarray.shear_dir() → array float{liner,3,3}.: Get a Numpy array of the direction (unit vector in global system) in which the liner element is being loaded by the shear coupling spring at each node.

itasca.structure.linerarray.shear_disp() → array float{liner,3}.: Get a Numpy array of the displacement magnitude in the shear coupling spring at each node. The coupling spring lies in the tangent plane of the liner surface. The direction in which force is acting is given by \(shear_dir\) method.

itasca.structure.linerarray.shear_friction() → array float{liner,2}.: Get a Numpy array of the shear coupling spring friction angle for each side of the liner elements.

itasca.structure.linerarray.shear_residual() → array float{liner,2}.: Get a Numpy array of the shear coupling spring residual cohesion for each side of the liner elements.

itasca.structure.linerarray.shear_state() → (int, int, int, int, int, int).: Get a Numpy array of the yield state of the coupling spring at each side of each node. Return values 1, 2 and 3 denotes never yielded, yielding now, or yielded in the past, respectively. Side 1 and 2 of node 1 are given first.

itasca.structure.linerarray.shear_stiffness() → array float{liner,2}.: Get a Numpy array of the shear coupling spring stiffness for each side of the liner elements.

itasca.structure.linerarray.shear_stress() → array float{liner,3}.: Get a Numpy array of the stress magnitude in the coupling spring at each node. The coupling spring lies in the tangent plane of the liner surface. The direction in which force is acting is given by the \(shear_dir\) method.

itasca.structure.linerarray.slide() → array bool{liner}.: Get a Numpy array of the large-strain sliding flag. A true value denotes that the large-strain sliding is on.

itasca.structure.linerarray.slide_tol() → array float{liner}.: Get a Numpy array of the (shear) coupling spring slide tolerance of the liner elements.

itasca.structure.linerarray.stress(location: int) → stens3.: Get a Numpy array of the stresses at the current depth factor at the index \(location\). A \(location\) value of 0 gives the stress at the element centroid; \(location\) values 1, 2 and 3 give the stress at the nodes. Stresses are expressed in the global system. Note that compressive stresses are negative.

itasca.structure.linerarray.stress_prin(location: int) → vec3.: Get the resolved principal stress at the current depth factor at the index \(location\). A \(location\) value of 0 gives the stress at the element centroid; \(location\) values 1, 2 and 3 give the stress at the nodes. Returns a vector encoded as (minimum, intermediate, maximum). Note that compressive stresses are negative in FLAC3D.

itasca.structure.linerarray.stress_valid() → array bool{liner}.: Get a Numpy array of the stress validity flag for the element. True indicates that the stresses last calculated at the current depth factor are valid. Galse indicates that stresses have not been calculated, or that there has been a change that invalidates the last stresses calculated.

itasca.structure.linerarray.thermal_expansion() → array double{liner}.: Get a NumPy array of the thermal expansion coefficient of liner elements.

itasca.structure.linerarray.thickness() → array float{liner}.: Get a Numpy array of the element thickness.

itasca.structure.linerarray.type() → array string{liner}.: Get a NumPy array of the type name of liner elements.

itasca.structure.linerarray.volume() → array float{liner}.: Get a Numpy array of the element volume, or surface area times thickness.

itasca.structure.linerarray.young() → array float{liner}.: Get a Numpy array of the Youngs modulus of the elements. Modifying the value during cycling may be a danger.

⇄

⇐ itasca.structure.geogridarray | itasca.structure.link ⇒

Was this helpful? ...

Updated: Dec 19, 2024