/// <summary>
/// Retrieves an existing named point spring property.
/// </summary>
/// <param name="name">The name of the point spring property.</param>
/// <param name="stiffnessSource">The source of the spring stiffness derivation.</param>
/// <param name="effectiveStiffness">The effective stiffness.</param>
/// <param name="coordinateSystem">The name of the coordinate system in which the property is defined.</param>
/// <param name="soilProfile">The name of an existing Soil Profile.</param>
/// <param name="footing">The name of an existing Isolated Column Footing.</param>
/// <param name="period">The first-mode time period. [sec].</param>
/// <param name="color">The display color for the property specified as an integer.</param>
/// <param name="notes">The notes, if any, assigned to the property.</param>
/// <param name="GUID">The GUID (global unique identifier), if any, assigned to the property.</param>
public void GetPointSpringProperties(string name,
ref eSpringStiffnessDerivation stiffnessSource,
ref Stiffness effectiveStiffness,
ref string coordinateSystem,
ref string soilProfile,
ref string footing,
ref double period,
ref int color,
ref string notes,
ref string GUID)
{
double[] k = new double[0];
int csiStiffnessSource = 0;
_callCode = _sapModel.PropPointSpring.GetPointSpringProp(name,
ref csiStiffnessSource,
ref k,
ref coordinateSystem,
ref soilProfile, ref footing, ref period,
ref color, ref notes, ref GUID);
if (throwCurrentApiException(_callCode))
{
throw new CSiException();
}
stiffnessSource = (eSpringStiffnessDerivation)csiStiffnessSource;
effectiveStiffness.FromArray(k);
}
/// <summary>
/// This function retrieves uncoupled spring stiffness assignments for a point element;
/// that is, it retrieves the diagonal terms in the 6x6 spring matrix for the point element.
/// The spring stiffnesses reported are the sum of all springs assigned to the point element either directly or indirectly through line, area and solid spring assignments.
/// The spring stiffness values are reported in the point local coordinate system.
/// </summary>
/// <param name="name">The name of an existing point element.</param>
/// <param name="stiffnesses">Spring stiffness values for each decoupled degree of freedom.</param>
/// <exception cref="CSiException"></exception>
public void GetSpring(string name,
ref Stiffness stiffnesses)
{
double[] csiStiffnesses = new double[0];
_callCode = _sapModel.PointElm.GetSpring(name, ref csiStiffnesses);
if (throwCurrentApiException(_callCode))
{
throw new CSiException();
}
stiffnesses.FromArray(csiStiffnesses);
}
/// <summary>
/// Returns uncoupled spring stiffness assignments for a point element;
/// that is, it retrieves the diagonal terms in the 6x6 spring matrix for the point element.
/// The spring stiffnesses reported are the sum of all springs assigned to the point element either directly or indirectly through line, area and solid spring assignments.
/// The spring stiffness values are reported in the point local coordinate system.
/// </summary>
/// <param name="name">The name of an existing point element.</param>
/// <exception cref="CSiException"><see cref="CSiApiBase.API_DEFAULT_ERROR_CODE" /></exception>
public Stiffness GetSpring(string name)
{
double[] csiStiffnesses = new double[0];
_callCode = _sapModel.PointElm.GetSpring(name, ref csiStiffnesses);
if (throwCurrentApiException(_callCode))
{
throw new CSiException(API_DEFAULT_ERROR_CODE);
}
Stiffness stiffnesses = new Stiffness();
stiffnesses.FromArray(csiStiffnesses);
return(stiffnesses);
}
