Operations
Last update: 10.02.2025Operations | |
API used to evalute a Field Meta Model of Optimal Prognosis (FMOP) | |
| DYNARDO_FMOP_API fmop_error_t | FMOP_approxField (const fmop_handle_t fmop, const double *param_values, double *field) |
| Approximates a field response based on a vector of given active scalar input parameters. More... | |
| DYNARDO_FMOP_API fmop_error_t | FMOP_approxFieldExtrapolate (const fmop_handle_t fmop, const double *param_values, double *field) |
| Approximates a field response based on a vector of given active scalar input parameters. More... | |
Detailed Description
Function Documentation
◆ FMOP_approxField()
| DYNARDO_FMOP_API fmop_error_t FMOP_approxField | ( | const fmop_handle_t | fmop, |
| const double * | param_values, | ||
| double * | field | ||
| ) |
Approximates a field response based on a vector of given active scalar input parameters.
- Parameters
-
[in] fmop A successfully initialized fmop_handle_t data object [in] param_values Vector of a single sample of all active scalar input parameters. Size and parameter order are defined by the return values of FMOP_getModelParamIdents()
param_values [j]... the index j matches the parameter input name position returned in the param_idents argument of FMOP_getModelParamIdents()
sizeof ( param_values ) ... must match the num_params argument of FMOP_getModelParamIdents() The values must not be located outside the initial sampling bounds.[out] field An already initialized array of size num_mesh_items as returned by FMOP_getModelDim() On output contains the approximated field response.
Follows the scheme:![$ field[k] $](/sites/default/files/migrate-content/optislang_c_api_of_fmopsolver_library_2025_r1_1/form_2.png)
k...internal mesh item ident, e.g. internal signal position, internal element number
Call FMOP_getDataPointIndices() to map internal to external numbering scheme
- Returns
- fmop_invalid_handle if the fmop handle is not allocated.
- fmop_license_error if a license error occurs, e.g. no license has been acquired so far or one tries to release a 3D mesh but acquired a SoS license for 1D meshes, e.g. signals, only
- fmop_settings_error if the param_values or field array argument is a NULL pointer
- fmop_exception_occurred if any other failure get invoked
- fmop_success elsewise
- Call FMOP_getErrnoString() to get a human readable representation. For detailed log messages call FMOP_getLastError() which outputs internal log messages.
◆ FMOP_approxFieldExtrapolate()
| DYNARDO_FMOP_API fmop_error_t FMOP_approxFieldExtrapolate | ( | const fmop_handle_t | fmop, |
| const double * | param_values, | ||
| double * | field | ||
| ) |
Approximates a field response based on a vector of given active scalar input parameters.
- Parameters
-
[in] fmop A successfully initialized fmop_handle_t data object [in] param_values Vector of a single sample of all active scalar input parameters. Size and parameter order are defined by the return values of FMOP_getModelParamIdents()
param_values [j]... the index j matches the parameter input name position returned in the param_idents argument of FMOP_getModelParamIdents()
sizeof ( param_values ) ... must match the num_params argument of FMOP_getModelParamIdents() The values may be located outside the initial sampling bounds.[out] field An already initialized array of size num_mesh_items as returned by FMOP_getModelDim() On output contains the approximated field response.
Follows the scheme:![$ field[k] $](/sites/default/files/migrate-content/optislang_c_api_of_fmopsolver_library_2025_r1_1/form_2.png)
k...internal mesh item ident, e.g. internal signal position, internal element number
Call FMOP_getDataPointIndices() to map internal to external numbering scheme
- Returns
- fmop_invalid_handle if the fmop handle is not allocated.
- fmop_license_error if a license error occurs, e.g. no license has been acquired so far or one tries to release a 3D mesh but acquired a SoS license for 1D meshes, e.g. signals, only
- fmop_settings_error if the param_values or field array argument is a NULL pointer
- fmop_exception_occurred if any other failure get invoked
- fmop_success elsewise
- Call FMOP_getErrnoString() to get a human readable representation. For detailed log messages call FMOP_getLastError() which outputs internal log messages.