Rate This Document

Findability

Accuracy

Completeness

Readability

KmlDssInit

Create a solver operation handle.

Interface Definition

C interface:

int KmlDssInit(KmlDssSolver **pSolver, const KmlDssInitOption *option);

Parameters

Parameter	Type	Description	Input/Output
pSolver	KmlDssSolver **	Solver handle pointer, which cannot be a null pointer.	Input/Output
option	KmlDssInitOption *	Solver configuration option, which cannot be a null pointer. For details, see Table 1.	Input

**Table 1** KmlDssInitOption structure
Field	Type	Description
fieldMask	uint64_t	Mask that determines to which fields the configuration is applied. If a bit is set to 1, its corresponding field uses a specified value. If a bit is set to 0, its corresponding field uses the default value. See the individual field description for configurable mask bits.
bwrMode	KmlDssBWRMode	Bit-wise reproducibility control options. The options are as follows: KMLDSS_BWR_OFF indicates that binary reproducibility is not guaranteed. This is the default option. KMLDSS_BWR_FIXED_THREADS ensures binary reproducibility across multiple runs using the same thread count. Mask bit: KMLDSS_INIT_OPTION_BWR_MODE
nThreads	int32_t	Initial number of solver threads. If not set, the number of threads in the OpenMP parallel region is used by default. Mask bit: KMLDSS_INIT_OPTION_NTHREADS

Return Value

Return Value	Type	Description
KMLSS_NO_ERROR	int	Normal execution.
KMLSS_INTERNAL_ERROR	int	Internal error.
KMLSS_NULL_ARGUMENT	int	A null argument exists in {pSolver, option}.

Dependencies

#include "kml_dss.h"

Parent topic: Solver Functions