RiO-DETRv2
RiO-DETRv2は、リアルタイムの回転ボックス向けDETRです。ボックスの4辺をボックス自身の座標系における分布として推定し、角度を粗から細へと補正し、角度を考慮した品質で各ボックスをスコア付けします。LibreYOLOはこれを推論専用で、5つのサイズとDOTA-v1.0およびDIOR-Rのチェックポイントとともに移植しています。
- タスク
- oriented boxes
- インストール
pip install libreyolo- サポートティア
- 推論のみ、v1.8.0以降。推論、検証、エクスポートのみです。学習機能は対象外です。
- ライセンス
- コード:Apache-2.0、重み:Apache-2.0。商用利用
インストール
RiO-DETRv2にオプションのextraは不要です。
pip install libreyolo推論
重みは初回使用時にLibreYOLOのHugging Faceミラーからダウンロードされます。モデルは航空画像で学習されているため、上空から撮影した写真を使ってください。
from libreyolo import LibreYOLO model = LibreYOLO("LibreRiODETRv2s-obb.pt") # DOTA-v1.0、15クラスresult = model("aerial.jpg", save=True) print(result.obb.xywhr) # (N, 5)、中心、サイズ、角度print(result.obb.conf, result.obb.cls)from libreyolo import LibreYOLO model = LibreYOLO("LibreRiODETRv2s-obb-diorr.pt") # DIOR-R、20クラスresult = model("aerial.jpg")libreyolo predict model=LibreRiODETRv2s-obb.pt source=aerial.jpg save=Trueresult.obbは回転ボックスを保持します。xywhr(中心、幅、高さ、角度)、conf、clsで、クラス名はチェックポイントから取得します。ペイロードと描画については回転物体検出のタスクページを参照してください。
バリアント
サイズはn、s、m、l、xの5つで、それぞれ2つのチェックポイントがあります。
| チェックポイント | データセット | クラス数 | キャンバス |
|---|---|---|---|
LibreRiODETRv2<size>-obb.pt | DOTA-v1.0 | 15 | 1024 px |
LibreRiODETRv2<size>-obb-diorr.pt | DIOR-R | 20 | 800 px |
ネイティブのキャンバスはチェックポイントから読み取られます。生の出力とデコードした回転ボックスは、CPU上の10個すべてのチェックポイントで、アップストリームのApache-2.0のリリースと完全に一致します(最大絶対差0)。
RiO-DETRv2は推論専用です。train()は例外を発生させます。アップストリームの学習レシピ(DINOv3の特徴量蒸留、OBBのハンガリアンマッチング、境界と角度の分布損失)は移植していません。学習可能な回転ボックス検出には、GTRまたはYOLO-NASを使ってください。
エクスポート
| タスク | ONNX | TorchScript | ExecuTorch | TensorRT | OpenVINO | Paddle | MNN | RKNN | Axelera | ncnn | TFLite | CoreML | Core AI |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Oriented boxes | Oriented boxes to ONNX:対応 | Oriented boxes to TorchScript:対応 | Oriented boxes to ExecuTorch:対応 | Oriented boxes to TensorRT:対応 | Oriented boxes to OpenVINO:対応 | Oriented boxes to Paddle:非対応 | Oriented boxes to MNN:非対応 | Oriented boxes to RKNN:非対応 | Oriented boxes to Axelera:非対応 | Oriented boxes to ncnn:非対応 | Oriented boxes to TFLite:非対応 | Oriented boxes to CoreML:非対応 | Oriented boxes to Core AI:非対応 |
ONNXとTorchScriptのエクスポートは往復可能です。エクスポートしたファイルはLibreYOLO()で再度読み込まれ、同じResultsを返します。
from libreyolo import LibreYOLO model = LibreYOLO("LibreRiODETRv2s-obb.pt")model.export(format="onnx")model.export(format="torchscript")libreyolo export model=LibreRiODETRv2s-obb.pt format=onnxチェックポイント
| ファイル | 重みのライセンス |
|---|---|
| Oriented boxes | |
| LibreRiODETRv2l-obb.pt | apache-2.0 |
| LibreRiODETRv2l-obb-diorr.pt | apache-2.0 |
| LibreRiODETRv2m-obb.pt | apache-2.0 |
| LibreRiODETRv2m-obb-diorr.pt | apache-2.0 |
| LibreRiODETRv2n-obb.pt | apache-2.0 |
| LibreRiODETRv2n-obb-diorr.pt | apache-2.0 |
| LibreRiODETRv2s-obb.pt | apache-2.0 |
| LibreRiODETRv2s-obb-diorr.pt | apache-2.0 |
| LibreRiODETRv2x-obb.pt | apache-2.0 |
| LibreRiODETRv2x-obb-diorr.pt | apache-2.0 |
上記のすべてのファイルは現在LibreYOLO orgにあり、初回使用時にダウンロードされます。
ライセンス
ダウンロードする特定の重みについて、Hugging Faceリポジトリのライセンスを確認してください。LibreYOLO orgの各チェックポイントにはライセンスが付与されており、同じファミリー内でも常に同一とは限りません。そのリポジトリが正式な情報源です。以下の概要は、このページを最後に検証した時点で適用されていた内容を示します。
これは関連するライセンスの説明であり、法的助言ではありません。商用上重要な場合は、自分でライセンスを読み、専門家の助言を受けてください。
- 原著作物
- RiO-DETRv2, RiO-DETRv2 authors (RicePasteM)
- アップストリームのライセンス
- Apache-2.0
- アップストリームのソース
- github.com/RicePasteM/RiO-DETRv2
- LibreYOLOのコード
- MIT
- 重み
- Apache-2.0、huggingface.co/LibreYOLOで再公開
- 解釈
- Apache-2.0 is a permissive license, so the RiO-DETRv2 code and checkpoints can be used in commercial and closed-source products. Redistributing them means keeping the license text and notices, and the license grants a patent license. About 33 minutes after its initial commit (ab8b22df5d800a927774c8c67e77fd29c0fe6967), upstream changed its LICENSE file to AGPL-3.0; later commits change only the README and LICENSE, not the code. LibreYOLO's port relies on the Apache-2.0 grant of that initial release, uses nothing from later commits, and preserves the Apache-2.0 snapshot at LibreYOLO/RiO-DETRv2 (tag apache-2.0-ab8b22d). The adapted decoder keeps Apache-2.0 with its RT-DETR, D-FINE, DEIM and RT-DETRv4 copyright lines (libreyolo/models/riodetrv2/LICENSE and NOTICE); the HGNetv2 backbone, encoder and decoder blocks reuse LibreYOLO's dfine and rtdetrv2 families, and the wiring around them is LibreYOLO's MIT code. The official checkpoints (Hugging Face RicePasteM/RiO-DETRv2 at revision 5f578f57929aded1962ebf8c5584a4771461124f, tagged apache-2.0) are mirrored as LibreYOLO/LibreRiODETRv2{n,s,m,l,x}-obb (DOTA-v1.0) and -obb-diorr (DIOR-R) with the upstream LICENSE and NOTICE; conversion renames keys and drops a training-only projector, learned tensors are unchanged. The DOTA-v1.0 and DIOR-R training sets carry their own terms.
RiO-DETRv2はRicePasteMによるものです(RicePasteM/RiO-DETRv2)。コードと重みはApache-2.0のため、商用利用が可能です。アップストリームは最初のコミットから約33分後に、コードを変更せずにLICENSEファイルをAGPL-3.0に変更しました。LibreYOLOの移植版はその最初のApache-2.0のリリース(コミットab8b22d)のみを使い、そのスナップショットをLibreYOLO/RiO-DETRv2に保存しています。公式のチェックポイントは、キーの名前を変更し学習済みテンソルは変更せずに、LibreYOLO/LibreRiODETRv2{n,s,m,l,x}-obbおよび-obb-diorrとしてミラーしています。DOTA-v1.0とDIOR-Rの学習セットにはそれぞれ独自の利用条件があります。
引用
@misc{hu2026riodetrv2geometryawareuncertaintymodeling,
title={RiO-DETRv2: Geometry-Aware Uncertainty Modeling Meets Real-Time Oriented Object Detection Transformer},
author={Zhangchi Hu and Zilong He and Yifan Zhao and Xiangyu Yu and Jie Chen and Peixi Wu and Yansong Peng and Hebei Li and Xiaoyan Sun},
year={2026},
eprint={2610.29159},
archivePrefix={arXiv},
primaryClass={cs.CV},
url={https://arxiv.org/abs/2610.29159},
}著者によるarxiv.org/bibtex/2610.29159の引用ブロックからコピーしています。