Gridpoint

class itasca.gridpoint.Gridpoint

Objects of this type should not be created (instantiated) directly in Python. Use the module functions that return instances of this type.

convergence() → float.

Get the gridpoint gridpoint convergence value, defined as the ratio of the currenct local force ratio (gridpoint ratio member) to the target force ratio (gridpoint ratio_target method). A value of 1 or less is therefore considered converged.

copy_to(destination: gridpoint) → None.

Copy the gridpoint state information from this gridpoint to the given gridpoint.

disp() → vec.

Get the gridpoint displacement (vector).

disp_small() → vec.

Get the gridpoint small displacement vector for the gridpoint. Small displacements are incremented from velocity and timestep only in small strain model. See the command model large. The small strain vector field is used in the interface logic to calculate overlaps (vector).

disp_small_x() → float.

Get the x-component of the gridpoint small displacement vector for the gridpoint. Small displacements are incremented from velocity and timestep only in small strain model. See the command model large. The small strain vector field is used in the interface logic to calculate overlaps.

disp_small_y() → float.

Get the y-component of the gridpoint small displacement vector for the gridpoint. Small displacements are incremented from velocity and timestep only in small strain model. See the command model large. The small strain vector field is used in the interface logic to calculate overlaps.

disp_x() → float.

Get the x-component of the gridpoint displacement.

disp_y() → float.

Get the y-component of the gridpoint displacement.

extra(slot: int) → any.

Get the gridpoint extra data in the given slot.

fix(component: int) → bool.

Get the gridpoint fixity condition. The first argument is the vector component.

force_app() → vec.

Get the gridpoint total applied force at a gridpoint. This includes all sources, including forces due to gravity (vector).

force_app_x() → float.

Get the x-component of the gridpoint total applied force at a gridpoint. This includes all sources, including forces due to gravity.

force_app_y() → float.

Get the y-component of the gridpoint total applied force at a gridpoint. This includes all sources, including forces due to gravity.

force_load() → vec.

Get the gridpoint user applied load (vector).

force_load_x() → float.

Get the x-component of the gridpoint user applied load.

force_load_y() → float.

Get the y-component of the gridpoint user applied load.

force_unbal() → vec.

Get the gridpoint unbalanced force (vector).

force_unbal_x() → float.

Get the x-component of the gridpoint unbalanced force.

force_unbal_y() → float.

Get the y-component of the gridpoint unbalanced force.

group([slot: str]) → str.

Get the gridpoint group name in a given slot.

group_remove(group_name: str) → bool.

Remove from the given group from all group slots of the gridpoint. One argument of type string, giving the group name, is required. The return value is a bool which is True if the group was removed from any slot, otherwise False.

groups() → {slot: group_name}.

Get a dictionary describing which groups this gridpoint is part of. The keys of the dictionary are the slot names and the values are the group names.

id() → int.

Get the gridpoint id.

in_group(group_name: str[, slot: str]) → bool.

Test if the gridpoint is part of a given group. If the optional argument slot is given, only that slot is searched. Otherwise, all group slots are searched.

local_small() → bool.

Get the gridpoint local small strain setting.

mass_add() → vec.

Get the gridpoint added mass vector for the gridpoint. This mass is added to the inertial mass of the gridpoint during equations of motion (vector).

mass_add_x() → float.

Get the x-component of the gridpoint added mass vector for the gridpoint. This mass is added to the inertial mass of the gridpoint during equations of motion.

mass_add_y() → float.

Get the y-component of the gridpoint added mass vector for the gridpoint. This mass is added to the inertial mass of the gridpoint during equations of motion.

mass_gravity() → float.

Get the gridpoint gravitational mass.

mass_inertial() → float.

Get the gridpoint gridpoint inertial mass.

pos() → vec.

Get the gridpoint centroid location (vector).

pos_x() → float.

Get the x-component of the gridpoint centroid location.

pos_y() → float.

Get the y-component of the gridpoint centroid location.

ratio() → float.

Get the gridpoint local gridpoint mechanical convergence ratio.

ratio_target() → float.

Get the gridpoint target local gridpoint mechanical convergence ratio. The default value is 1e-4. A local force ratio (gridpoint ratio method) below this value is considered converged. See the convergence Gridpoint method.

set_disp(value: vec) → None.

Set the gridpoint displacement (vector).

set_disp_small(value: vec) → None.

Set the gridpoint small displacement vector for the gridpoint. Small displacements are incremented from velocity and timestep only in small strain model. See the command model large. The small strain vector field is used in the interface logic to calculate overlaps (vector).

set_disp_small_x(value: float) → None.

Set the x-component of the gridpoint small displacement vector for the gridpoint. Small displacements are incremented from velocity and timestep only in small strain model. See the command model large. The small strain vector field is used in the interface logic to calculate overlaps.

set_disp_small_y(value: float) → None.

Set the y-component of the gridpoint small displacement vector for the gridpoint. Small displacements are incremented from velocity and timestep only in small strain model. See the command model large. The small strain vector field is used in the interface logic to calculate overlaps.

set_disp_x(value: float) → None.

Set the x-component of the gridpoint displacement.

set_disp_y(value: float) → None.

Set the y-component of the gridpoint displacement.

set_extra(slot: int, value: any) → None.

Set the gridpoint extra data in the given slot.

set_fix(component: int, fix: bool) → None.

Set the gridpoint fixity condition. The first argument is the vector component to set and the second components is a the fixity flag. The component starts at 0.

set_force_load(value: vec) → None.

Set the gridpoint user applied load (vector).

set_force_load_x(value: float) → None.

Set the x-component of the gridpoint user applied load.

set_force_load_y(value: float) → None.

Set the y-component of the gridpoint user applied load.

set_group(group_name: str[, slot: str]) → None.

Set the gridpoint group name in a given slot.

set_local_small(value: bool) → None.

Set the gridpoint local small strain setting.

set_mass_add(value: vec) → None.

Set the gridpoint added mass vector for the gridpoint. This mass is added to the inertial mass of the gridpoint during equations of motion (vector).

set_mass_add_x(value: float) → None.

Set the x-component of the gridpoint added mass vector for the gridpoint. This mass is added to the inertial mass of the gridpoint during equations of motion.

set_mass_add_y(value: float) → None.

Set the y-component of the gridpoint added mass vector for the gridpoint. This mass is added to the inertial mass of the gridpoint during equations of motion.

set_pos(value: vec) → None.

Set the gridpoint centroid location (vector).

set_pos_x(value: float) → None.

Set the x-component of the gridpoint centroid location.

set_pos_y(value: float) → None.

Set the y-component of the gridpoint centroid location.

set_ratio_target(value: float) → None.

Set the gridpoint target local gridpoint mechanical convergence ratio. The default value is 1e-4. A local force ratio (gridpoint ratio method) below this value is considered converged. See the convergence Gridpoint method.

set_vel(value: vec) → None.

Set the gridpoint velocity (vector).

set_vel_x(value: float) → None.

Set the x-component of the gridpoint velocity.

set_vel_y(value: float) → None.

Set the y-component of the gridpoint velocity.

stiff() → float.

Get the gridpoint accumulated gridpoint effective stiffness.

valid() → bool.

Returns True if this gridpoint is live.

vel() → vec.

Get the gridpoint velocity (vector).

vel_x() → float.

Get the x-component of the gridpoint velocity.

vel_y() → float.

Get the y-component of the gridpoint velocity.

zones() → tuple of Zone objects.

Get a tuple of the zones attached to this gridpoint.