Skip to main content

optiSLang 3D Postprocessing Script API 2025 R1

CreateLegacyMOQModel Class Reference

Last update: 16.07.2025

Defines a LegacyMOPModel This type of model wraps the old MOQ and makes it accessible to The MOP framework. Used Properties: More...

Public Member Functions

virtual string __str__ ()
 Output function used in python context. Use this function to print instances of this class in python. More...
 
virtual addProperty (PropertyBase p)
 Properties that help the ScalarMOP scheduling the Models to be built The properties class needs to be implemented for the specific model type.
 
ModelBasecompute (::data_handler::DataHandlerBase datahandler, TrainingPlanBase training_plan, quality_measure::QualityMeasureBase quality_measure)
 Builds the model from the given samples and returns the model. More...
 
 CreateLegacyMOQModel ()
 Creates an default initialized instance of this class.
 
 CreateLegacyMOQModel (CreateLegacyMOQModel other)
 Copies an instance of this class.
 
virtual PropertyList getProperties ()
 Returns the properties stored by this user.
 
virtual bool isValid (::data_handler::DataHandlerBase datahandler, TrainingPlanBase training_plan) override
 Destroys an instance of this class. More...
 
CreateLegacyMOQModel operator= (CreateLegacyMOQModel)
 Copies an instance of this class.
 
virtual transferProperties (PropertyList property_list)
 Convenience function to transfer a complete PropertyList into the model. More...
 

Public Attributes

number altsupport
 Defines the usage of localization points. Default: 0. If this value is 0, then each sample (design) of a DOE will be used directly as localization point for the RBF interpolation. If this value is greater zero, then it is equal to the number of localization points to be used (eg. 1000). The localization points will be samples to match roughly the statistical properties of the input DOE. Use this option, if there are too many samples and the creation of the default eta model will take too much time.
 
number anisotropic
 Defines if the RBF interpolation functions are anisotropic. Value 1: Ansitotropy is used; Value 0: RBF funtions are isotropic. Anisotropy means in this context, that the RBF functions are scaled by a distance factor individually for each input parameter dimension.
 
number corrfilter
 Defines the usage of the correlation filter. The correlation filter tries to eliminate input parameters that are not significantly correlated to the response. The amount of correlation is measured in terms of a polynomial regression model. Only as many inputs are consideres as important as long as they increase the CoP of the polynomial regression model. Therefore, one may ensure that certain parameters are not removed by defining them as 'mandatory' or by using the mincorr option that defines the significance level of important parameters. A value of 0 means not active; The filter is active for a value of greater than 0. In the latter case, the filter becomes only active if more inputs are available than the number in this item.
 
bool generate_auto_settings
 if true, then FMOP will automatically generate a settings object, if false the settings of this object will be chosen.
 
number mincorr
 Defines the significance level of the correlation filter This value is only used when the corrfilter option is set (corrfilter!=0). It ensures that input parameters with a 'significant' linear correlation to the response are not eliminated as 'unimportant' when the correlation filter is active. The value defines a significance value from which the actual correlation value is computed that is required to enforce that an input becomes mandatory if the correlation between this input and the response is greater than this limit value. The significance value is first translated into a t-distribution of a test variable.
 
number mineval
 Defines the input-correlation filter Value of zero: There is not filter using input-correlations Values greater than zero: This is the smallest eigenvalue of the input-correlation matrix which is interpreted as non-zero! The inputs associated with eigenvalues below will be eliminated.
 
string node_name
 
number reshuffles
 Defines the number of shuffles in the computation of the sensitivities. Default value: 0. The special value of 0 means that as many shuffles as designs are used. This version takes most time, but is most accurate. A value greater 0 defines the actual number of shuffles. More...
 
number tolerance
 tolerance for the internal iterative algorithm This tolerance is used by the optimizer as termination criterion that tests: (a) gradients being near zero (b) objective function value improvements decline to nearly zero. The optimizer is used to determine the model coefficients. More...
 
bool use_basic_fit
 if true, then FMOP will use basic polynomial regression fit only.
 
string working_dir
 

Detailed Description

Defines a LegacyMOPModel This type of model wraps the old MOQ and makes it accessible to The MOP framework. Used Properties:

  • ComplexityProperty

Member Function Documentation

◆ __str__()

virtual string __str__ ( )
virtualinherited

Output function used in python context. Use this function to print instances of this class in python.

Returns
string containing the object

Reimplemented in CreateCustomModel.

◆ compute()

ModelBase* compute ( ::data_handler::DataHandlerBase  datahandler,
TrainingPlanBase  training_plan,
quality_measure::QualityMeasureBase  quality_measure 
)

Builds the model from the given samples and returns the model.

Parameters
datahandlerThe datahandler that contains the samples
training_planThe training plan that specifies how the model will be trained
quality_measureThe quality measure that allows to compute a models approximation quality
Returns
The trained model iff not cancelled

◆ isValid()

virtual bool isValid ( ::data_handler::DataHandlerBase  datahandler,
TrainingPlanBase  training_plan 
)
overridevirtual

Destroys an instance of this class.

This function checks if the model can validly be trained from the given samples

Parameters
samplesThe samples the model shall be trained with.
Returns
True iff th emodel can be trained with the configuration data, the properties and samples

Implements CreateModelBase.

◆ transferProperties()

virtual transferProperties ( PropertyList  property_list)
virtualinherited

Convenience function to transfer a complete PropertyList into the model.

Parameters
property_listThe properties to transfer into this model

Member Data Documentation

◆ reshuffles

number reshuffles

Defines the number of shuffles in the computation of the sensitivities. Default value: 0. The special value of 0 means that as many shuffles as designs are used. This version takes most time, but is most accurate. A value greater 0 defines the actual number of shuffles.

Note
Do not mistake this with the number of shuffles in the cross-validation! This is different!

◆ tolerance

number tolerance

tolerance for the internal iterative algorithm This tolerance is used by the optimizer as termination criterion that tests: (a) gradients being near zero (b) objective function value improvements decline to nearly zero. The optimizer is used to determine the model coefficients.

Default: 0.001; Meaningful values are 1e-1 ... 1e-4.

Connect with Ansys