PP-DocLayoutV3
PP-DocLayoutV3 is PaddleOCR's document layout detector. It finds the regions of a page (text, titles, tables, figures, formulas, headers, footers, seals and more) and ranks them in reading order. LibreYOLO ports it as a detect family that needs no transformers or PaddlePaddle runtime.
- 작업
- detection
- 크기
- l at 800 px
- 설치
pip install libreyolo- 지원 티어
- 추론 전용, v1.8.0부터 지원. 예측, 검증, 내보내기만 지원합니다. 학습 기능은 적용되지 않습니다.
- 라이선스
- 코드 Apache-2.0, 가중치 Apache-2.0. 상업적 사용
Install
PP-DocLayoutV3 needs no optional extra. It is pure PyTorch and everything it imports is in the base install.
pip install libreyoloPredict
Weights download from LibreYOLO/LibrePPDocLayoutV3l on first use.
from libreyolo import LibreYOLO model = LibreYOLO("LibrePPDocLayoutV3l.pt")result = model("page.png", conf=0.5) # the upstream pipeline's threshold for order, box, cls, score in zip( result.reading_order, result.boxes.xyxy, result.boxes.cls, result.boxes.conf): print(int(order), result.names[int(cls)], round(float(score), 3), box.tolist())libreyolo predict model=LibrePPDocLayoutV3l.pt source=page.png conf=0.5 save=Truefrom libreyolo import LibreYOLO # Upstream's model.safetensors loads too: it is converted once and a# LibreYOLO checkpoint is written beside it.model = LibreYOLO("model.safetensors")Results.boxes holds xyxy boxes on the original page, confidences and class
ids over 25 layout classes. Rows are sorted in reading order, and
Results.reading_order is a one-based int64 vector aligned with the boxes. It
slices with results[i] like track_id and appears as reading_order in
Results.summary() rows. Ranks are computed among the regions kept at conf;
a classes= filter or a max_det cut keeps the surviving ranks, so the values
can have gaps.
The upstream pipeline uses conf=0.5; LibreYOLO's default conf=0.25 keeps
more low-confidence regions. As upstream, scores are per-class sigmoids and the
top 300 (query, class) pairs are kept, so one region can be reported with two
labels. No NMS is applied.
Classes: abstract, algorithm, aside_text, chart, content,
display_formula, doc_title, figure_title, footer, footer_image,
footnote, formula_number, header, header_image, image,
inline_formula, number, paragraph_title, reference,
reference_content, seal, table, text, vertical_text,
vision_footnote.
The same port runs the layout stage of Falcon OCR
with layout=True.
Variants
One size, l: an RT-DETR-style set-prediction detector with an HGNetV2-L
backbone, mask-enhanced query initialisation and a global-pointer head that
scores every pair of regions. Input is a fixed 800x800 canvas (stretch resize,
RGB in [0, 1], no normalization). It runs on CPU, CUDA and MPS; on MPS the
positional encoding is computed in float32, so results can differ in the last
bits.
Against the Apache-2.0 PyTorch reference in transformers, on CUDA in fp32 with the same input tensor, logits, boxes, reading-order logits and masks match exactly on three real pages and a random tensor. Training is not offered: it needs reading-order and per-region mask supervision that LibreYOLO's detect datasets do not carry. The per-region polygons upstream derives from the mask branch are not exposed.
Export
| 작업 | ONNX | TorchScript | ExecuTorch | TensorRT | OpenVINO | Paddle | MNN | RKNN | Axelera | ncnn | TFLite | CoreML | Core AI |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Detection | Detection to ONNX: 지원함 | Detection to TorchScript: 지원함 | Detection to ExecuTorch: 지원함 | Detection to TensorRT: 지원함 | Detection to OpenVINO: 지원함 | Detection to Paddle: 지원하지 않음 | Detection to MNN: 지원하지 않음 | Detection to RKNN: 지원하지 않음 | Detection to Axelera: 지원하지 않음 | Detection to ncnn: 지원하지 않음 | Detection to TFLite: 지원하지 않음 | Detection to CoreML: 지원하지 않음 | Detection to Core AI: 지원하지 않음 |
ONNX (opset 17) and TorchScript, fixed 800x800, FP32. The graph outputs
pred_logits, pred_boxes and order_votes; exported backends return the
same Results, including reading_order.
from libreyolo import LibreYOLO model = LibreYOLO("LibrePPDocLayoutV3l.pt")model.export(format="onnx") # fixed 800x800, FP32model.export(format="torchscript")libreyolo export model=LibrePPDocLayoutV3l.pt format=onnxfrom libreyolo import LibreYOLO model = LibreYOLO("LibrePPDocLayoutV3l.onnx")result = model("page.png", conf=0.5)print(result.reading_order)Checkpoints
| 파일 | 입력(px) | 가중치 라이선스 |
|---|---|---|
| Detection | ||
| LibrePPDocLayoutV3l.pt | 800 | apache-2.0 |
위의 모든 파일은 현재 LibreYOLO 조직에 있으며 처음 사용할 때 내려받습니다.
Licensing
내려받는 특정 가중치의 Hugging Face 저장소에서 라이선스를 확인하십시오. LibreYOLO 조직의 모든 체크포인트에는 라이선스가 있으며 한 계열 안에서도 항상 같지는 않습니다. 해당 저장소가 신뢰할 수 있는 기준입니다. 아래 요약은 이 페이지를 마지막으로 검증했을 때 적용된 내용을 설명합니다.
관련 라이선스에 관한 설명이며 법률 자문이 아닙니다. 상업적으로 중요한 사안이라면 라이선스를 직접 읽고 별도의 법률 자문을 받으십시오.
- 원작
- PP-DocLayoutV3, PaddlePaddle Authors
- 업스트림 라이선스
- Apache-2.0
- LibreYOLO 코드
- MIT
- 가중치
- Apache-2.0, huggingface.co/LibreYOLO에 다시 게시됨
- 해석
- Apache-2.0 is a permissive license, so the PP-DocLayoutV3 weights and LibreYOLO's port can be used in commercial and closed-source products. Redistributing them means keeping the license text and attribution notices, and the license grants a patent license. LibreYOLO's network is an inference-only PyTorch port of the Apache-2.0 reference in Hugging Face Transformers (v5.22.1, commit 446a570e62b04a89ea001604ada7366baac2ea67, Copyright The PaddlePaddle Team and The HuggingFace Inc. team) and needs no transformers runtime (libreyolo/models/ppdoclayoutv3/NOTICE). The checkpoint is converted from PaddlePaddle/PP-DocLayoutV3_safetensors at revision e4f489dc536556fc1be02b973ba06756e0d4a2ac, declared Apache-2.0 by its model card; that repository ships no LICENSE file, so the mirror at LibreYOLO/LibrePPDocLayoutV3l carries the Apache-2.0 text of the PaddleOCR project. Conversion only strips a key prefix and adds metadata; learned parameters are unchanged, and the mirror is not gated.
PP-DocLayoutV3 is Apache-2.0, code and weights, by the
PaddlePaddle Authors. Commercial
use is allowed. The checkpoint is converted from
PaddlePaddle/PP-DocLayoutV3_safetensors by stripping a key prefix and adding
metadata; learned parameters are unchanged and the mirror is not gated.
Citation
@misc{cui2026rtdoclayoutrealtimeendtoenddocument,
title={RT-DocLayout: Real-Time End-to-End Document Layout Analysis with Reading Order in the Wild},
author={Cheng Cui and Tingquan Gao and Xueqing Wang and Changda Zhou and Hongen Liu and Ting Sun and Yubo Zhang and Zelun Zhang and Jiaxuan Liu and Manhui Lin and Yue Zhang and Suyin Liang and Yiqing Xiang and Yi Liu},
year={2026},
eprint={2606.23344},
archivePrefix={arXiv},
primaryClass={cs.CV},
url={https://arxiv.org/abs/2606.23344},
}huggingface.co/PaddlePaddle/PP-DocLayoutV3_safetensors#citation에 있는 저자의 인용 블록에서 복사했습니다.