qbcompiler.configs.models.CompileConfig Class Reference

qbcompiler.configs.models.CompileConfig Class Reference#

Mobilint SDK qb Compiler: qbcompiler.configs.models.CompileConfig Class Reference

Mobilint SDK qb Compiler v1.4

MCS002-EN

Unified compilation configuration for Mobilint MXQ compilation. More...

Inheritance diagram for qbcompiler.configs.models.CompileConfig:

Public Member Functions
"CompileConfig"	with_uint8_input (self, **kwargs)
	Return a copy with uint8_input settings enabled.
"CompileConfig"	with_preprocessing (self, **kwargs)
	Return a copy with preprocessing settings enabled.
"CompileConfig"	with_hessian_quant (self, **kwargs)
	Return a copy with hessian_quant settings enabled.
"CompileConfig"	with_bias_correction (self, **kwargs)
	Return a copy with bias_correction settings enabled.
"CompileConfig"	with_mod (self, **kwargs)
	Return a copy with mod settings enabled.
"CompileConfig"	with_llm (self, **kwargs)
	Return a copy with llm settings enabled.
"CompileConfig"	with_search_weight_scale (self, **kwargs)
	Return a copy with search_weight_scale settings enabled.
"CompileConfig"	with_load_scale (self, **kwargs)
	Return a copy with load_scale settings enabled.
"CompileConfig"	with_save_sample (self, **kwargs)
	Return a copy with save_sample settings enabled.
"CompileConfig"	with_extra_output (self, **kwargs)
	Return a copy with extra_output settings enabled.
"CompileConfig"	from_file (cls, Union[str, Path] path)
	Load config from YAML or JSON file.
"CompileConfig"	from_preset (cls, str name)
	Load config from a preset.
None	to_file (self, Union[str, Path] path)
	Save config to YAML or JSON file.

Static Public Attributes
	model_config
List	model_paths
List	calib_data_path
List	save_paths
bool	use_random_calib
str	inference_scheme
bool	cpu_offload
bool	force_npu_input_reposition
bool	force_npu_output_reposition
int	optimize_option
int	buffer_mode
str	device = Field(default="gpu", description="Device for computation")
str	dtype = Field(default="float", description="Data type for computation")
bool	debug = Field(default=False, description="Enable debug mode")
bool	trace = Field(default=False, description="Enable trace mode")
int	image_channels
str	config_version
List	split_blocks
int	split_parts
Uint8InputConfig	uint8_input
PreprocessingConfig	preprocessing = Field(default_factory=PreprocessingConfig)
ResourceManagementConfig	resource_management
CalibrationConfig	calibration = Field(default_factory=CalibrationConfig)
BitConfig	bit = Field(default_factory=BitConfig)
HessianQuantConfig	hessian_quant
BiasCorrectionConfig	bias_correction
ModConfig	mod = Field(default_factory=ModConfig)
LlmConfig	llm = Field(default_factory=LlmConfig)
MoeConfig	moe = Field(default_factory=MoeConfig)
EquivalentTransformationConfig	equivalent_transformation
SearchWeightScaleConfig	search_weight_scale
LoadScaleConfig	load_scale
RuntimeOptions	runtime_options
SaveSampleConfig	save_sample
ExtraOutputConfig	extra_output

Static Protected Member Functions
dict	_flatten_grouped_json (dict data)
	Flatten grouped JSON keys (e.g.
dict	_group_to_json (dict data)
	Group flat keys back into nested JSON structure (inverse of _flatten_grouped_json).

Detailed Description

Unified compilation configuration for Mobilint MXQ compilation.

Definition at line 1898 of file models.py.

Member Function Documentation

◆ with_uint8_input()

"CompileConfig" qbcompiler.configs.models.CompileConfig.with_uint8_input	(		self,
		**	kwargs )

Return a copy with uint8_input settings enabled.

Definition at line 2010 of file models.py.

◆ with_preprocessing()

"CompileConfig" qbcompiler.configs.models.CompileConfig.with_preprocessing	(		self,
		**	kwargs )

Return a copy with preprocessing settings enabled.

Definition at line 2016 of file models.py.

◆ with_hessian_quant()

"CompileConfig" qbcompiler.configs.models.CompileConfig.with_hessian_quant	(		self,
		**	kwargs )

Return a copy with hessian_quant settings enabled.

Definition at line 2022 of file models.py.

◆ with_bias_correction()

"CompileConfig" qbcompiler.configs.models.CompileConfig.with_bias_correction	(		self,
		**	kwargs )

Return a copy with bias_correction settings enabled.

Definition at line 2028 of file models.py.

◆ with_mod()

"CompileConfig" qbcompiler.configs.models.CompileConfig.with_mod	(		self,
		**	kwargs )

Return a copy with mod settings enabled.

Definition at line 2034 of file models.py.

◆ with_llm()

"CompileConfig" qbcompiler.configs.models.CompileConfig.with_llm	(		self,
		**	kwargs )

Return a copy with llm settings enabled.

Definition at line 2040 of file models.py.

◆ with_search_weight_scale()

"CompileConfig" qbcompiler.configs.models.CompileConfig.with_search_weight_scale	(		self,
		**	kwargs )

Return a copy with search_weight_scale settings enabled.

Definition at line 2046 of file models.py.

◆ with_load_scale()

"CompileConfig" qbcompiler.configs.models.CompileConfig.with_load_scale	(		self,
		**	kwargs )

Return a copy with load_scale settings enabled.

Definition at line 2052 of file models.py.

◆ with_save_sample()

"CompileConfig" qbcompiler.configs.models.CompileConfig.with_save_sample	(		self,
		**	kwargs )

Return a copy with save_sample settings enabled.

Definition at line 2058 of file models.py.

◆ with_extra_output()

"CompileConfig" qbcompiler.configs.models.CompileConfig.with_extra_output	(		self,
		**	kwargs )

Return a copy with extra_output settings enabled.

Definition at line 2064 of file models.py.

◆ from_file()

"CompileConfig" qbcompiler.configs.models.CompileConfig.from_file	(		cls,
		Union[str, Path]	path )

Load config from YAML or JSON file.

Definition at line 2077 of file models.py.

◆ _flatten_grouped_json()

dict qbcompiler.configs.models.CompileConfig._flatten_grouped_json ( dict data )

staticprotected

Flatten grouped JSON keys (e.g.

quantization.calibration) to flat structure.

Definition at line 2089 of file models.py.

◆ from_preset()

"CompileConfig" qbcompiler.configs.models.CompileConfig.from_preset	(		cls,
		str	name )

Load config from a preset.

Definition at line 2115 of file models.py.

◆ _group_to_json()

dict qbcompiler.configs.models.CompileConfig._group_to_json ( dict data )

staticprotected

Group flat keys back into nested JSON structure (inverse of _flatten_grouped_json).

Definition at line 2122 of file models.py.

◆ to_file()

None qbcompiler.configs.models.CompileConfig.to_file	(		self,
		Union[str, Path]	path )

Save config to YAML or JSON file.

Definition at line 2153 of file models.py.

Member Data Documentation

◆ model_config

qbcompiler.configs.models.CompileConfig.model_config

static

Initial value:

=  ConfigDict(
        populate_by_name=True,
        extra="forbid",
    )

Definition at line 1901 of file models.py.

◆ model_paths

List qbcompiler.configs.models.CompileConfig.model_paths

static

Initial value:

=  Field(
        default=[], alias="modelPaths", description="Paths to model files"
    )

Definition at line 1906 of file models.py.

◆ calib_data_path

List qbcompiler.configs.models.CompileConfig.calib_data_path

static

Initial value:

=  Field(
        default=[], alias="calibDataPaths", description="Paths to calibration datasets"
    )

Definition at line 1909 of file models.py.

◆ save_paths

List qbcompiler.configs.models.CompileConfig.save_paths

static

Initial value:

=  Field(
        default=["./tmp.mxq"],
        alias="savePaths",
        description="Output MXQ filename/paths",
    )

Definition at line 1912 of file models.py.

◆ use_random_calib

bool qbcompiler.configs.models.CompileConfig.use_random_calib

static

Initial value:

=  Field(
        default=False, alias="useRandomCalib", description="Use random calibration"
    )

Definition at line 1917 of file models.py.

◆ inference_scheme

str qbcompiler.configs.models.CompileConfig.inference_scheme

static

Initial value:

=  Field(
        default="single", alias="inferenceScheme", description="NPU inference scheme"
    )

Definition at line 1920 of file models.py.

◆ cpu_offload

bool qbcompiler.configs.models.CompileConfig.cpu_offload

static

Initial value:

=  Field(
        default=False,
        alias="cpuOffload",
        description="Enable CPU offload for unsupported operators",
    )

Definition at line 1923 of file models.py.

◆ force_npu_input_reposition

bool qbcompiler.configs.models.CompileConfig.force_npu_input_reposition

static

Initial value:

=  Field(
        default=False,
        alias="forceNpuInputReposition",
        description="Force input reposition operations to run on NPU instead of CPU",
    )

Definition at line 1928 of file models.py.

◆ force_npu_output_reposition

bool qbcompiler.configs.models.CompileConfig.force_npu_output_reposition

static

Initial value:

=  Field(
        default=False,
        alias="forceNpuOutputReposition",
        description="Force output reposition operations to run on NPU instead of CPU",
    )

Definition at line 1933 of file models.py.

◆ optimize_option

int qbcompiler.configs.models.CompileConfig.optimize_option

static

Initial value:

=  Field(
        default=1,
        alias="optimizeOption",
        description="Compiler optimization selector",
        ge=0,
    )

Definition at line 1938 of file models.py.

◆ buffer_mode

int qbcompiler.configs.models.CompileConfig.buffer_mode

static

Initial value:

=  Field(
        default=1, alias="bufferMode", description="Buffer serialization mode"
    )

Definition at line 1944 of file models.py.

◆ device

str qbcompiler.configs.models.CompileConfig.device = Field(default="gpu", description="Device for computation")

static

Definition at line 1947 of file models.py.

◆ dtype

str qbcompiler.configs.models.CompileConfig.dtype = Field(default="float", description="Data type for computation")

static

Definition at line 1948 of file models.py.

◆ debug

bool qbcompiler.configs.models.CompileConfig.debug = Field(default=False, description="Enable debug mode")

static

Definition at line 1949 of file models.py.

◆ trace

bool qbcompiler.configs.models.CompileConfig.trace = Field(default=False, description="Enable trace mode")

static

Definition at line 1950 of file models.py.

◆ image_channels

int qbcompiler.configs.models.CompileConfig.image_channels

static

Initial value:

=  Field(
        default=0,
        alias="imageChannels",
        description="Number of image channels (0 for auto-detect)",
    )

Definition at line 1951 of file models.py.

◆ config_version

str qbcompiler.configs.models.CompileConfig.config_version

static

Initial value:

=  Field(
        default="1.0.0", alias="configVersion", description="Config schema version"
    )

Definition at line 1956 of file models.py.

◆ split_blocks

List qbcompiler.configs.models.CompileConfig.split_blocks

static

Initial value:

=  Field(
        default=[],
        alias="splitBlocks",
        description="Multi-MXQ split points by transformer block index",
    )

Definition at line 1959 of file models.py.

◆ split_parts

int qbcompiler.configs.models.CompileConfig.split_parts

static

Initial value:

=  Field(
        default=0,
        alias="splitParts",
        description="Evenly split transformer blocks into N MXQ parts",
    )

Definition at line 1964 of file models.py.

◆ uint8_input

Uint8InputConfig qbcompiler.configs.models.CompileConfig.uint8_input

static

Initial value:

=  Field(
        default_factory=Uint8InputConfig, alias="uint8Input"
    )

Definition at line 1970 of file models.py.

◆ preprocessing

PreprocessingConfig qbcompiler.configs.models.CompileConfig.preprocessing = Field(default_factory=PreprocessingConfig)

static

Definition at line 1973 of file models.py.

◆ resource_management

ResourceManagementConfig qbcompiler.configs.models.CompileConfig.resource_management

static

Initial value:

=  Field(
        default_factory=ResourceManagementConfig, alias="resourceManagement"
    )

Definition at line 1974 of file models.py.

◆ calibration

CalibrationConfig qbcompiler.configs.models.CompileConfig.calibration = Field(default_factory=CalibrationConfig)

static

Definition at line 1977 of file models.py.

◆ bit

BitConfig qbcompiler.configs.models.CompileConfig.bit = Field(default_factory=BitConfig)

static

Definition at line 1978 of file models.py.

◆ hessian_quant

HessianQuantConfig qbcompiler.configs.models.CompileConfig.hessian_quant

static

Initial value:

=  Field(
        default_factory=HessianQuantConfig, alias="hessianQuant"
    )

Definition at line 1979 of file models.py.

◆ bias_correction

BiasCorrectionConfig qbcompiler.configs.models.CompileConfig.bias_correction

static

Initial value:

=  Field(
        default_factory=BiasCorrectionConfig, alias="biasCorrection"
    )

Definition at line 1982 of file models.py.

◆ mod

ModConfig qbcompiler.configs.models.CompileConfig.mod = Field(default_factory=ModConfig)

static

Definition at line 1985 of file models.py.

◆ llm

LlmConfig qbcompiler.configs.models.CompileConfig.llm = Field(default_factory=LlmConfig)

static

Definition at line 1986 of file models.py.

◆ moe

MoeConfig qbcompiler.configs.models.CompileConfig.moe = Field(default_factory=MoeConfig)

static

Definition at line 1987 of file models.py.

◆ equivalent_transformation

EquivalentTransformationConfig qbcompiler.configs.models.CompileConfig.equivalent_transformation

static

Initial value:

=  Field(
        default_factory=EquivalentTransformationConfig, alias="equivalentTransformation"
    )

Definition at line 1988 of file models.py.

◆ search_weight_scale

SearchWeightScaleConfig qbcompiler.configs.models.CompileConfig.search_weight_scale

static

Initial value:

=  Field(
        default_factory=SearchWeightScaleConfig, alias="searchWeightScale"
    )

Definition at line 1991 of file models.py.

◆ load_scale

LoadScaleConfig qbcompiler.configs.models.CompileConfig.load_scale

static

Initial value:

=  Field(
        default_factory=LoadScaleConfig, alias="loadScale"
    )

Definition at line 1994 of file models.py.

◆ runtime_options

RuntimeOptions qbcompiler.configs.models.CompileConfig.runtime_options

static

Initial value:

=  Field(
        default_factory=RuntimeOptions, alias="runtimeOptions"
    )

Definition at line 1997 of file models.py.

◆ save_sample

SaveSampleConfig qbcompiler.configs.models.CompileConfig.save_sample

static

Initial value:

=  Field(
        default_factory=SaveSampleConfig, alias="saveSample"
    )

Definition at line 2000 of file models.py.

◆ extra_output

ExtraOutputConfig qbcompiler.configs.models.CompileConfig.extra_output

static

Initial value:

=  Field(
        default_factory=ExtraOutputConfig, alias="extraOutput"
    )

Definition at line 2003 of file models.py.

The documentation for this class was generated from the following file:

models.py

qbcompiler.configs.models.CompileConfig Class Reference

qbcompiler.configs.models.CompileConfig Class Reference#

Public Member Functions

Static Public Attributes

Static Protected Member Functions

Detailed Description

Member Function Documentation

◆ with_uint8_input()

◆ with_preprocessing()

◆ with_hessian_quant()

◆ with_bias_correction()

◆ with_mod()

◆ with_llm()

◆ with_search_weight_scale()

◆ with_load_scale()

◆ with_save_sample()

◆ with_extra_output()

◆ from_file()

◆ _flatten_grouped_json()

◆ from_preset()

◆ _group_to_json()

◆ to_file()

Member Data Documentation

◆ model_config

◆ model_paths

◆ calib_data_path

◆ save_paths

◆ use_random_calib

◆ inference_scheme

◆ cpu_offload

◆ force_npu_input_reposition

◆ force_npu_output_reposition

◆ optimize_option

◆ buffer_mode

◆ device

◆ dtype

◆ debug

◆ trace

◆ image_channels

◆ config_version

◆ split_blocks

◆ split_parts

◆ uint8_input

◆ preprocessing

◆ resource_management

◆ calibration

◆ bit

◆ hessian_quant

◆ bias_correction

◆ mod

◆ llm

◆ moe

◆ equivalent_transformation

◆ search_weight_scale

◆ load_scale

◆ runtime_options

◆ save_sample

◆ extra_output