## On this page

  

 

 # Operations

 Last update: 10.02.2025 

## <a name="member-group"></a>Operations

<a class="anchor" id="amgrp456d0deba6a86c9585590550c797502d"></a> API used to evalute a Field Meta Model of Optimal Prognosis (FMOP)

DYNARDO\_FMOP\_API [fmop\_error\_t](group__types.xhtml#ga4847f3fa2943ffd694eb6cbe169a8bec) [FMOP\_approxField](group__operations.xhtml#ga1bd5d62d9c5ba6d327b0368a8b4e2e31) (const [fmop\_handle\_t](fmop__solver_8h.xhtml#aed65d1ae14f8c298a702ad5b828a70ef) fmop, const double \*param\_values, double \*field) Approximates a field response based on a vector of given active scalar input parameters. [More...](#ga1bd5d62d9c5ba6d327b0368a8b4e2e31)  
 DYNARDO\_FMOP\_API [fmop\_error\_t](group__types.xhtml#ga4847f3fa2943ffd694eb6cbe169a8bec) [FMOP\_approxFieldExtrapolate](group__operations.xhtml#ga4380a704857be093fc6444aa5b8fdadc) (const [fmop\_handle\_t](fmop__solver_8h.xhtml#aed65d1ae14f8c298a702ad5b828a70ef) fmop, const double \*param\_values, double \*field) Approximates a field response based on a vector of given active scalar input parameters. [More...](#ga4380a704857be093fc6444aa5b8fdadc)  
 <a id="details" name="details"></a>## Detailed Description

## Function Documentation

<a id="ga1bd5d62d9c5ba6d327b0368a8b4e2e31"></a>## [◆ ](#ga1bd5d62d9c5ba6d327b0368a8b4e2e31)FMOP\_approxField()

 DYNARDO\_FMOP\_API [fmop\_error\_t](group__types.xhtml#ga4847f3fa2943ffd694eb6cbe169a8bec) FMOP\_approxField  ( const [fmop\_handle\_t](fmop__solver_8h.xhtml#aed65d1ae14f8c298a702ad5b828a70ef)  *fmop*,    const double \*  *param\_values*,    double \*  *field*   ) 

Approximates a field response based on a vector of given active scalar input parameters.

Parameters \[in\]fmopA successfully initialized fmop\_handle\_t data object \[in\]param\_valuesVector of a single sample of all active scalar input parameters. Size and parameter order are defined by the return values of [FMOP\_getModelParamIdents()](group__queries.xhtml#ga485827623b3d01cf3157c0a16559908f "Returns all active scalar inputer parameters for the fmop handle given. ")  
 param\_values \[j\]... the index j matches the parameter input name position returned in the param\_idents argument of [FMOP\_getModelParamIdents()](group__queries.xhtml#ga485827623b3d01cf3157c0a16559908f "Returns all active scalar inputer parameters for the fmop handle given. ")   
 sizeof ( param\_values ) ... must match the num\_params argument of [FMOP\_getModelParamIdents()](group__queries.xhtml#ga485827623b3d01cf3157c0a16559908f "Returns all active scalar inputer parameters for the fmop handle given. ") The values must not be located outside the initial sampling bounds. \[out\]fieldAn already initialized array of size num\_mesh\_items as returned by [FMOP\_getModelDim()](group__queries.xhtml#ga24e43563d67cc64bffb7bccddbaada65 "Returns the size of the FCoP vector, aka the number of mesh items. ") 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()](group__queries.xhtml#gadd2527ad2ad1bf1df141e5fa5b4c2e31 "Maps internal node/element numbering to the external scheme consisting of part and item ID...") to map internal to external numbering scheme Returns- [fmop\_invalid\_handle](group__types.xhtml#gga4847f3fa2943ffd694eb6cbe169a8becacef5c059b0dd649f97d5404db95c3ccf "The function got an unexpected NULL pointer. ") if the fmop handle is not allocated.
- [fmop\_license\_error](group__types.xhtml#gga4847f3fa2943ffd694eb6cbe169a8becacf8dfe2eaba2eada73a26e487a04f8fe "No valid license available. ") 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](group__types.xhtml#gga4847f3fa2943ffd694eb6cbe169a8beca4040927e4d05d13e93b9f2c7373ca0cd "Input argument(s) is invalid or missing. ") if the param\_values or field array argument is a NULL pointer
- [fmop\_exception\_occurred](group__types.xhtml#gga4847f3fa2943ffd694eb6cbe169a8becadac3d9086cdab852d265dc924070c198 "An internal error occurred. Request log messages. ") if any other failure get invoked
- [fmop\_success](group__types.xhtml#gga4847f3fa2943ffd694eb6cbe169a8beca41a0a2e83b0ac20d414f4b015522ce55 "Function execution returned successfully. ") elsewise

Call [FMOP\_getErrnoString()](group__error__handling.xhtml#ga7e820b85d2ef2596b00bc82445dcf650 "Returns a string description for the error number given. ") to get a human readable representation. For detailed log messages call FMOP\_getLastError() which outputs internal log messages. 



<a id="ga4380a704857be093fc6444aa5b8fdadc"></a>## [◆ ](#ga4380a704857be093fc6444aa5b8fdadc)FMOP\_approxFieldExtrapolate()

 DYNARDO\_FMOP\_API [fmop\_error\_t](group__types.xhtml#ga4847f3fa2943ffd694eb6cbe169a8bec) FMOP\_approxFieldExtrapolate  ( const [fmop\_handle\_t](fmop__solver_8h.xhtml#aed65d1ae14f8c298a702ad5b828a70ef)  *fmop*,    const double \*  *param\_values*,    double \*  *field*   ) 

Approximates a field response based on a vector of given active scalar input parameters.

Parameters \[in\]fmopA successfully initialized fmop\_handle\_t data object \[in\]param\_valuesVector of a single sample of all active scalar input parameters. Size and parameter order are defined by the return values of [FMOP\_getModelParamIdents()](group__queries.xhtml#ga485827623b3d01cf3157c0a16559908f "Returns all active scalar inputer parameters for the fmop handle given. ")  
 param\_values \[j\]... the index j matches the parameter input name position returned in the param\_idents argument of [FMOP\_getModelParamIdents()](group__queries.xhtml#ga485827623b3d01cf3157c0a16559908f "Returns all active scalar inputer parameters for the fmop handle given. ")   
 sizeof ( param\_values ) ... must match the num\_params argument of [FMOP\_getModelParamIdents()](group__queries.xhtml#ga485827623b3d01cf3157c0a16559908f "Returns all active scalar inputer parameters for the fmop handle given. ") The values may be located outside the initial sampling bounds. \[out\]fieldAn already initialized array of size num\_mesh\_items as returned by [FMOP\_getModelDim()](group__queries.xhtml#ga24e43563d67cc64bffb7bccddbaada65 "Returns the size of the FCoP vector, aka the number of mesh items. ") 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()](group__queries.xhtml#gadd2527ad2ad1bf1df141e5fa5b4c2e31 "Maps internal node/element numbering to the external scheme consisting of part and item ID...") to map internal to external numbering scheme Returns- [fmop\_invalid\_handle](group__types.xhtml#gga4847f3fa2943ffd694eb6cbe169a8becacef5c059b0dd649f97d5404db95c3ccf "The function got an unexpected NULL pointer. ") if the fmop handle is not allocated.
- [fmop\_license\_error](group__types.xhtml#gga4847f3fa2943ffd694eb6cbe169a8becacf8dfe2eaba2eada73a26e487a04f8fe "No valid license available. ") 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](group__types.xhtml#gga4847f3fa2943ffd694eb6cbe169a8beca4040927e4d05d13e93b9f2c7373ca0cd "Input argument(s) is invalid or missing. ") if the param\_values or field array argument is a NULL pointer
- [fmop\_exception\_occurred](group__types.xhtml#gga4847f3fa2943ffd694eb6cbe169a8becadac3d9086cdab852d265dc924070c198 "An internal error occurred. Request log messages. ") if any other failure get invoked
- [fmop\_success](group__types.xhtml#gga4847f3fa2943ffd694eb6cbe169a8beca41a0a2e83b0ac20d414f4b015522ce55 "Function execution returned successfully. ") elsewise

Call [FMOP\_getErrnoString()](group__error__handling.xhtml#ga7e820b85d2ef2596b00bc82445dcf650 "Returns a string description for the error number given. ") to get a human readable representation. For detailed log messages call FMOP\_getLastError() which outputs internal log messages.