e11b487b19
Implements Phase 7.1.4: coverage-based fallback for Suspects-tagged PDFs. ## Changes ### New files - crates/pdftract-core/src/parser/marked_content.rs: MCID tracking and CoverageResult - crates/pdftract-core/tests/struct_tree_coverage.rs: Integration tests ### Modified files - crates/pdftract-core/src/parser/catalog.rs: MarkInfo::requires_coverage_check(), ReadingOrderAlgorithm enum - crates/pdftract-core/src/parser/struct_tree.rs: check_coverage_for_pages(), ParentTreeResolver::compute_coverage() - crates/pdftract-core/src/extract.rs: MCID tracking per page, coverage check integration ## Implementation Coverage calculation: - claimed_mcids = MCIDs resolving to non-Artifact StructElem via ParentTree - total_mcids = All MCIDs from marked-content sequences on the page - coverage = claimed_mcids / total_mcids Fallback rule (per plan §7.1 line 2572): - If /MarkInfo /Suspects is true AND coverage < 0.80 → use XY-cut - Otherwise → use StructTree ## Tests Unit tests (20): ✅ All passing - Suspects false + 50% coverage → no fallback - Suspects true + 95% coverage → no fallback - Suspects true + 60% coverage → fallback - Edge cases: no MCIDs, 80% threshold, multi-page Integration tests: ⚠️ Skipped (malformed fixture PDFs) - tagged-suspects-*.pdf have invalid xref tables - Core functionality verified by unit tests - Fixtures need regeneration or real-world tagged PDFs ## Acceptance Criteria (from pdftract-2w3r) - [x] Unit tests: Suspects false + 50% coverage → no fallback - [x] Unit tests: Suspects true + 95% coverage → no fallback - [x] Unit tests: Suspects true + 60% coverage → fallback - [x] Per-page diagnostic appears in receipts when fallback triggers - [x] reading_order_algorithm field set to "struct_tree" or "xy_cut" - [ ] Integration test: tagged-suspects-true.pdf (fixture malformed) Refs: pdftract-2w3r, plan §7.1 line 2554, INV-8 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
107 lines
1.7 KiB
Rust
107 lines
1.7 KiB
Rust
//! Generate a tagged PDF with /MarkInfo /Suspects true for testing Phase 7.1.4
|
|
//!
|
|
//! This creates a minimal tagged PDF with:
|
|
//! - /MarkInfo /Suspects true
|
|
//! - /StructTreeRoot with structure elements
|
|
//! - ParentTree with 60% coverage (triggers fallback)
|
|
//!
|
|
//! Usage: cargo run --bin generate_suspects_fixture
|
|
|
|
use std::fs::File;
|
|
use std::io::Write;
|
|
|
|
fn main() -> Result<(), Box<dyn std::error::Error>> {
|
|
let output_path = "tests/fixtures/tagged-suspects-true.pdf";
|
|
|
|
// Create a minimal PDF with /MarkInfo /Suspects true
|
|
// This is a manually crafted PDF that demonstrates the fallback behavior
|
|
|
|
let pdf_data = b"%PDF-1.7
|
|
1 0 obj
|
|
<<
|
|
/Type /Catalog
|
|
/Pages 2 0 R
|
|
/MarkInfo <<
|
|
/Marked true
|
|
/Suspects true
|
|
>>
|
|
/StructTreeRoot 3 0 R
|
|
>>
|
|
endobj
|
|
2 0 obj
|
|
<<
|
|
/Type /Pages
|
|
/Kids [4 0 R]
|
|
/Count 1
|
|
>>
|
|
endobj
|
|
3 0 obj
|
|
<<
|
|
/Type /StructTreeRoot
|
|
/K [5 0 R]
|
|
/ParentTree 6 0 R
|
|
>>
|
|
endobj
|
|
4 0 obj
|
|
<<
|
|
/Type /Page
|
|
/Parent 2 0 R
|
|
/MediaBox [0 0 612 792]
|
|
/Contents 7 0 R
|
|
/StructParents 0
|
|
>>
|
|
endobj
|
|
5 0 obj
|
|
<<
|
|
/Type /StructElem
|
|
/S /P
|
|
/K [0 1 2 3 4 5]
|
|
>>
|
|
endobj
|
|
6 0 obj
|
|
<<
|
|
/Nums [
|
|
0 [5 0 R 5 0 R 5 0 R 5 0 R 5 0 R 5 0 R null null null null]
|
|
]
|
|
>>
|
|
endobj
|
|
7 0 obj
|
|
<<
|
|
/Length 44
|
|
>>
|
|
stream
|
|
BT
|
|
/F1 12 Tf
|
|
100 700 Td
|
|
(Test) Tj
|
|
ET
|
|
endstream
|
|
endobj
|
|
xref
|
|
0 8
|
|
0000000000 65535 f
|
|
0000000009 00000 n
|
|
0000000099 00000 n
|
|
0000000163 00000 n
|
|
0000000245 00000 n
|
|
0000000341 00000 n
|
|
0000000413 00000 n
|
|
0000000539 00000 n
|
|
trailer
|
|
<<
|
|
/Size 8
|
|
/Root 1 0 R
|
|
>>
|
|
startxref
|
|
651
|
|
%%EOF";
|
|
|
|
let mut file = File::create(output_path)?;
|
|
file.write_all(pdf_data)?;
|
|
|
|
println!("Created fixture: {}", output_path);
|
|
println!("This PDF has /MarkInfo /Suspects true and 60% StructTree coverage.");
|
|
println!("Expected behavior: fallback to XY-cut, reading_order_algorithm = 'xy_cut'");
|
|
|
|
Ok(())
|
|
}
|