Struct LayoutDetectionConfig 

pub struct LayoutDetectionConfig {
    pub score_threshold: f32,
    pub max_elements: usize,
    pub class_thresholds: Option<HashMap<String, f32>>,
    pub class_merge_modes: Option<HashMap<String, MergeBboxMode>>,
    pub layout_nms: bool,
    pub nms_threshold: f32,
    pub layout_unclip_ratio: Option<UnclipRatio>,
}

Configuration for layout detection task.

Fields

score_threshold: f32

Default score threshold for detection (default: 0.5)

max_elements: usize

Maximum number of layout elements (default: 100)

class_thresholds: Option<HashMap<String, f32>>

Per-class score thresholds (overrides score_threshold for specific classes) PP-StructureV3 defaults:

• paragraph_title: 0.3
• formula: 0.3
• text: 0.4
• seal: 0.45
• others: 0.5

class_merge_modes: Option<HashMap<String, MergeBboxMode>>

Per-class bounding box merge modes

layout_nms: bool

Enable NMS for layout detection (default: true)

nms_threshold: f32

NMS threshold (default: 0.5)

layout_unclip_ratio: Option<UnclipRatio>

Unclip ratio for expanding/shrinking bounding boxes (PP-StructureV3) Default: [1.0, 1.0] (no change)

Implementations

impl LayoutDetectionConfig

pub fn with_pp_structurev3_thresholds() -> LayoutDetectionConfig

Creates a config with PP-StructureV3 default class thresholds.

PP-StructureV3 uses different thresholds for different element types:

• paragraph_title: 0.3
• formula: 0.3
• text: 0.4
• seal: 0.45
• others: 0.5 (default)

pub fn with_pp_doclayoutv2_defaults() -> LayoutDetectionConfig

Creates a config with PP-DocLayoutV2 default thresholds and merge modes.

These defaults are aligned with OpenOCR/OpenDoc’s pipeline config: OpenOCR/configs/rec/unirec/opendoc_pipeline.yml.

Notes:

• The postprocessor applies score_threshold before per-class thresholds, so we set it to the minimum per-class threshold (0.4) to avoid dropping valid candidates early.
• class_merge_modes is populated for all labels so merge behavior is deterministic.

pub fn with_pp_doclayoutv3_defaults() -> LayoutDetectionConfig

Creates a config with PP-DocLayoutV3 defaults (0.3 threshold + PP-DocLayout merge modes).

PP-DocLayoutV3 keeps the same label set as PP-DocLayoutV2 but uses a lower global threshold in the reference pipeline.

pub fn with_pp_structurev3_defaults() -> LayoutDetectionConfig

Creates a config with PP-StructureV3 default thresholds, merge modes, and unclip ratio.

Merge modes follow standard configuration:

• “large”: paragraph_title, image, formula, chart
• “union”: all other PP-DocLayout_plus-L classes

pub fn get_class_threshold(&self, class_name: &str) -> f32

Gets the threshold for a specific class.

Returns the class-specific threshold if configured, otherwise the default threshold.

pub fn get_class_merge_mode(&self, class_name: &str) -> MergeBboxMode

Gets the merge mode for a specific class.

Returns the class-specific merge mode if configured, otherwise Large (default).

Trait Implementations

impl Clone for LayoutDetectionConfig

fn clone(&self) -> LayoutDetectionConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ConfigValidator for LayoutDetectionConfig

fn validate(&self) -> Result<(), ConfigError>

Validates the configuration.

fn get_defaults() -> LayoutDetectionConfig

where LayoutDetectionConfig: Sized,

Returns the default configuration.

fn validate_batch_size(&self, batch_size: usize) -> Result<(), ConfigError>

Validates a batch size.

fn validate_batch_size_with_limits( &self, batch_size: usize, max_batch_size: usize, ) -> Result<(), ConfigError>

Validates a batch size against limits.

fn validate_model_path(&self, path: &Path) -> Result<(), ConfigError>

Validates a model path.

fn validate_image_dimensions( &self, width: u32, height: u32, ) -> Result<(), ConfigError>

Validates image dimensions.

fn validate_confidence_threshold( &self, threshold: f32, ) -> Result<(), ConfigError>

Validates a confidence threshold.

fn validate_memory_limit(&self, limit_mb: usize) -> Result<(), ConfigError>

Validates a memory limit.

fn validate_thread_count(&self, thread_count: usize) -> Result<(), ConfigError>

Validates thread count.

fn validate_f32_range( &self, value: f32, min: f32, max: f32, field_name: &str, ) -> Result<(), ConfigError>

Validates a float value is within a specified range.

fn validate_positive_f32( &self, value: f32, field_name: &str, ) -> Result<(), ConfigError>

Validates a float value is positive.

fn validate_positive_usize( &self, value: usize, field_name: &str, ) -> Result<(), ConfigError>

Validates a usize value is positive.

impl Debug for LayoutDetectionConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for LayoutDetectionConfig

fn default() -> LayoutDetectionConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for LayoutDetectionConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<LayoutDetectionConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for LayoutDetectionConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.