C_GetPanelPressureTimeHistory

Call C_GetPanelPressureTimeHistory to calculate time domain panel pressure results for an OrcaFlex vessel.

void C_GetPanelPressureTimeHistory(

TOrcFxAPIHandle VesselHandle,

TOrcFxAPIHandle DiffractionHandle,

int ResultPanelsCount,

const int *lpResultPanels,

const TPeriod *lpPeriod,

const TPanelPressureParameters *lpParameters,

double *lpOutput,

int *lpStatus

);

Parameters

VesselHandle (IN)

The handle of the vessel for which you want panel pressure results. The vessel must belong to a time domain OrcaFlex model. The OrcaFlex simulation must be complete – you can call C_RunSimulation2 to perform the simulation or call C_LoadSimulation to open an existing results file.

DiffractionHandle (IN)

The handle of an OrcaWave model model that includes the same vessel. DiffractionHandle can be obtained using C_CreateDiffraction. The OrcaWave calculation must be complete – you can call C_CalculateDiffraction to perform the calculation or call C_LoadDiffractionResults to open an existing results file. The model must include the output option for intermediate results.

ResultPanelsCount (IN)

The number of panels for which pressure is to be calculated – i.e. the size of the lpResultPanels array.

lpResultPanels (IN)

Points to an array of 0-based panel indices, of length ResultPanelsCount, specifying the panels for which pressure time history is to be calculated:

Each index must be in the range 0 to PanelCount-1 inclusive, where PanelCount is the number of panels for which OrcaWave panel results are available. PanelCount can be obtained by calling C_GetDiffractionOutput with the dotPanelCount output type.
Each index must specify a panel that belongs to the diffraction body corresponding to VesselHandle. If DiffractionHandle points to an OrcaWave model with more than one body, or with a damping lid, you may need to identify the owner of each panel. Do this by calling C_GetDiffractionOutput with the dotPanelGeometry output type and using the ObjectId member of the TDiffractionPanelGeometry structure.

lpPeriod (IN)

Points to a TPeriod variable that specifies the period of the simulation over which results are to be calculated.

lpParameters (IN)

Points to a TPanelPressureParameters structure that specifies the components of water pressure to be included in the panel pressure calculation.

If you include the diffraction component of panel pressure, the following requirement applies:

The calculation will include a non-zero contribution only if wave load (1^st order) is in the vessel's included effects.

If you include the radiation component of panel pressure, the following requirements apply:

The calculation will include a non-zero contribution only if added mass and damping is in the vessel's included effects.
The logging sample interval must equal the appropriate time step, i.e. the implicit integration time step or the explicit integration outer time step.
If the vessel belongs to a multibody group, the multibody group must include all the diffraction bodies from the OrcaWave model and in the same order.
If the OrcaWave model is multibody but you wish to neglect multibody effects in the OrcaFlex simulation, you must remove the vessel from its multibody group before running the simulation.

Tip:	Calculating the radiation component is particularly expensive. Use C_SetModelThreadCount to set the number of processing threads, in order to calculate pressure results in parallel for different panels. Use C_SetProgressHandler to set up a handler for progress notifications.

lpOutput (OUT)

Points to the output buffer, which is allocated by the caller. This is a two dimensional array with dimensions N, ResultPanelsCount. The array is in row-major order and N is the number of samples for this period. N can be obtained by calling C_GetNumOfSamples.

lpStatus (OUT)

Points to a variable in which the status result for the function call will be returned.