Coverage Reference

Model coverage

This page documents the detector, head, backbone, and neck names exposed by the current SimpleDet registries. Coverage here means registry-backed construction metadata and the validation status shown in source and CLI discovery, not benchmark parity with any external implementation.

CLI Discovery API Reference Developer Guide

Use this page before selecting a detector alias or deciding whether a family is runtime validated or only compatibility routed.

Status meanings

Status	Meaning
`runtime_validated`	The registry entry has native construction or tensor/runtime tests for the stated SimpleDet contract.
`metadata_validated`	The alias carries structured metadata for planning and discovery, but the row itself is not a full runtime parity claim.
`compatibility_alias`	The alias routes through native components, but it is not yet architecture-faithful enough to list as fully supported.
`unvalidated`	The name is registered for compatibility or migration only and should not be selected as fully supported.

Planned transformer variants, historical MMDetection configs, and notebook-only references are not supported model coverage until they have a registry entry plus tensor validation.

Detector coverage

Detector rows are sourced from the native detector registry and public discovery aliases. Default detector assembly usually also needs a supported backbone; TIMM-backed defaults require simpledet[timm].

Detector	Family	Aliases	Validation status	Required extra	Known limitation
RetinaNet	dense	`retinanet`, `retina`, `RetinaNet`	`runtime_validated`	`cpu`	Validated for the native Retina-style dense contract, not external benchmark parity.
FCOS	dense	`fcos`, `FCOS`	`runtime_validated`	`cpu`	Validated for the native anchor-free dense contract.
ATSS	dense	`atss`, `ATSS`	`runtime_validated`	`cpu`	Validated for the native anchor-based dense contract.
FSAF	dense	`fsaf`, `FSAF`	`compatibility_alias`	`cpu`	Routed through native dense components; not listed as architecture-faithful support.
FreeAnchor	dense	`free_anchor`, `FreeAnchor`	`compatibility_alias`	`cpu`	Retina-style compatibility path only.
GFL	dense	`gfl`, `GFL`	`runtime_validated`	`cpu`	Validated for the native GFL-style dense contract.
GFocalV2	dense	`gfocalv2`, `GFocalV2`, `GFLV2`	`compatibility_alias`	`cpu`	GFLv2 naming is routed through native dense components, but detector-level parity is not claimed.
VFNet	dense	`vfnet`, `VFNet`	`compatibility_alias`	`cpu`	Uses native ATSS-compatible components with varifocal head/loss support; not fully VFNet-faithful.
FOVEA / FoveaBox	dense	`fovea`, `foveabox`, `FOVEA`, `FoveaBox`	`compatibility_alias`	`cpu`	Native Fovea-style head is available, but detector-level architecture parity is not claimed.
PAA	dense	`paa`, `PAA`	`compatibility_alias`	`cpu`	Probabilistic assignment naming is exposed through a native dense route only.
RepPoints	dense	`reppoints`, `RepPoints`	`compatibility_alias`	`cpu`	Requires explicit point generation settings; detector path reuses native anchor-free contracts.
YOLOF	dense	`yolof`, `YOLOF`	`compatibility_alias`	`cpu`	YOLOF-style head and DilatedEncoder neck exist; detector-level parity is not claimed.
TOOD	dense	`tood`, `TOOD`	`compatibility_alias`	`cpu`	Task-aligned dense naming route only.
DDOD	dense	`ddod`, `DDOD`	`compatibility_alias`	`cpu`	Decoupled dense naming route only.
AutoAssign	dense	`auto_assign`, `AutoAssign`	`compatibility_alias`	`cpu`	Auto-assignment naming route only.
NAS-FCOS	dense	`nas_fcos`, `NAS-FCOS`	`compatibility_alias`	`cpu`	NAS-FCOS naming route only.
CenterNet	dense	`centernet`, `CenterNet`	`runtime_validated`	`cpu`	Validated for native heatmap, width-height, offset, and decode paths.
CornerNet	dense	`cornernet`, `CornerNet`	`runtime_validated`	`cpu`	Validated for paired corner heatmaps, embeddings, offsets, and native decode.
YOLO family	dense	`yolo`, `YOLO`, `yolo3`, `yolo4`, `yolo_v3`, `yolov3`, `yolov4`, `yolov5`, `yolov6`, `yolov7`, `yolov8`, `yolov9`, `yolov10`	`compatibility_alias`	`cpu`	Routes through the YOLOX-compatible neck, head, target, and decode path; version-specific YOLO parity is not claimed.
YOLOX	dense	`yolox`, `YOLOX`	`runtime_validated`	`cpu`	Validated with YOLOXPAFPN, objectness outputs, simOTA-style targets, and decode.
RTMDet	dense	`rtmdet`, `rtmdet_tiny`, `rtmdet_s`, `rtmdet_m`, `rtmdet_l`, `RTMDet`	`runtime_validated`	`cpu`	Validated for the native RTMDet head and YOLOXPAFPN-compatible path.
SSD	dense	`ssd`, `ssd300`, `ssd512`, `ssdlite`, `SSD`	`runtime_validated`	`cpu`	Validated for SSDNeck, native SSD head, and anchor decode.
EfficientDet	dense	`efficientdet`, `efficientdet_d0`, `efficientdet_d1`, `efficientdet_d2`, `EfficientDet`	`runtime_validated`	`cpu`; default backbone uses `timm`	Validated for EfficientNet/BiFPN/native head assembly; install `simpledet[timm]` for default native module construction.
SOLOv2	dense	`solov2`, `solov2_light`	`compatibility_alias`	`cpu`	Historical dense route only; instance segmentation parity is not claimed.
DETR	transformer	`detr`, `DETR`	`runtime_validated`	`cpu`	2D query detector scaffold with native logits, boxes, and decode.
Conditional DETR	transformer	`conditional_detr`, `conditionaldetr`, `ConditionalDETR`, `Conditional DETR`	`runtime_validated`	`cpu`	2D query detector scaffold; unsupported v2 names are rejected.
DAB-DETR	transformer	`dab_detr`, `dabdetr`, `DAB-DETR`, `DABDETR`	`runtime_validated`	`cpu`	2D query detector scaffold; unsupported v2 names are rejected.
Deformable DETR	transformer	`deformable_detr`, `deformabledetr`, `DeformableDETR`, `Deformable DETR`	`runtime_validated`	`cpu`	2D query detector scaffold; Deformable DETR v2 names are planned, unsupported.
DINO	transformer	`dino`, `DINO`	`runtime_validated`	`cpu`	2D query detector scaffold; DINOv2 is planned, unsupported.
RPN	proposal	`rpn`, `RPN`, `RPN detector`, `Region Proposal Network`	`runtime_validated`	`cpu`	Proposal-only detector path.
Fast R-CNN	roi	`fast_rcnn`, `fast-rcnn`, `Fast R-CNN`	`runtime_validated`	`cpu`	ROI bbox path without an RPN stage.
Faster R-CNN	roi	`faster_rcnn`, `faster-rcnn`, `Faster R-CNN`	`runtime_validated`	`cpu`	Native RPN plus ROI bbox path.
Mask R-CNN	roi	`mask_rcnn`, `mask-rcnn`, `Mask R-CNN`	`runtime_validated`	`cpu`	Native mask head contract is validated; full dataset benchmark parity is not claimed.
Grid R-CNN	roi	`grid_rcnn`, `gridrcnn`, `Grid R-CNN`	`runtime_validated`	`cpu`	Native grid ROI head contract is validated.
Cascade R-CNN	roi	`cascade_rcnn`, `cascadercnn`, `Cascade R-CNN`	`runtime_validated`	`cpu`	Native cascade bbox refinement path is validated.
Cascade Mask R-CNN	roi	`cascade_mask_rcnn`, `cascademaskrcnn`, `Cascade Mask R-CNN`	`runtime_validated`	`cpu`	Native cascade bbox plus mask contracts are validated.
Libra R-CNN	roi	`libra_rcnn`, `librarcnn`, `Libra R-CNN`	`runtime_validated`	`cpu`	Balanced ROI sampling contract is represented; external parity is not claimed.
Double-Head R-CNN	roi	`double_head_rcnn`, `doubleheadrcnn`, `Double-Head R-CNN`	`runtime_validated`	`cpu`	Native double-head ROI feature contract is validated.
Dynamic R-CNN	roi	`dynamic_rcnn`, `dynamicrcnn`, `Dynamic R-CNN`	`runtime_validated`	`cpu`	Native dynamic ROI feature path is validated.
Sparse R-CNN	roi	`sparse_rcnn`, `sparsercnn`, `Sparse R-CNN`	`runtime_validated`	`cpu`	Validated with learned proposal boxes/features and sparse ROI refinement.

Head coverage

Head rows are registry entries. Rows marked unvalidated are compatibility names and must not be treated as fully supported heads.

Head	Kind	Aliases	Validation status	Required extra	Known limitation
RetinaHead	dense	`retina`, `retina_head`	`runtime_validated`	`cpu`	Wraps the native Retina-style dense output contract.
RetinaNetHead	head	-	`unvalidated`	-	Compatibility name only; use `RetinaHead` for validated support.
FCOSHead	dense	`fcos`, `fcos_head`	`runtime_validated`	`cpu`	Native anchor-free dense contract.
FCOSV2Head	head	-	`unvalidated`	-	Registered naming variant only.
FCOSHeadV2	head	-	`unvalidated`	-	Registered naming variant only.
FSAFHead	dense	`fsaf`, `fsaf_head`	`runtime_validated`	`cpu`	FSAF-style head contract, separate from detector-level architecture parity.
FreeAnchorRetinaHead	dense	`free_anchor`, `free_anchor_head`, `free_anchor_retina_head`	`runtime_validated`	`cpu`	Retina-style dense head variant.
GFLHead	dense	`gfl`, `gfl_head`, `gfocal`, `gfocal_head`	`runtime_validated`	`cpu`	Uses the native ATSS-style dense output contract.
GFLV2Head	dense	`GFLV2`, `gflv2_head`, `gfocalv2`, `gfocalv2_head`	`runtime_validated`	`cpu`	Head contract is validated; detector-level GFocalV2 remains a compatibility alias.
ATSSHead	dense	`atss`, `atss_head`	`runtime_validated`	`cpu`	Native anchor-based dense contract.
ATSSV2Head	head	-	`unvalidated`	-	Registered naming variant only.
RPNHead	dense	`rpn`, `rpn_head`	`runtime_validated`	`cpu`	Class-agnostic proposal head.
VFNetHead	dense	`VFNet`, `vfnet_head`	`runtime_validated`	`cpu`	Head contract is validated; detector-level VFNet remains a compatibility alias.
RepPointsHead	dense	`RepPoints`, `reppoints_head`	`runtime_validated`	`cpu`	Requires point stride metadata at construction.
FoveaHead	dense	`FOVEA`, `fovea_head`	`runtime_validated`	`cpu`	Head contract is validated; detector-level FoveaBox remains a compatibility alias.
PAAHead	dense	`PAA`, `paa_head`	`runtime_validated`	`cpu`	Uses the native ATSS-style dense output contract.
TOODHead	dense	`TOOD`, `tood_head`	`runtime_validated`	`cpu`	Uses the native FCOS-style dense output contract.
DDODHead	dense	`DDOD`, `ddod_head`	`runtime_validated`	`cpu`	Uses the native ATSS-style dense output contract.
AutoAssignHead	dense	`AutoAssign`, `auto_assign_head`	`runtime_validated`	`cpu`	Uses the native FCOS-style dense output contract.
NASFCOSHead	dense	`NAS-FCOS`, `nas_fcos_head`	`runtime_validated`	`cpu`	Uses the native FCOS-style dense output contract.
YOLOFHead	dense	`YOLOF`, `yolof_head`	`runtime_validated`	`cpu`	Head contract is validated; detector-level YOLOF remains a compatibility alias.
YOLOXHead	dense	`yolox`, `yolox_head`	`runtime_validated`	`cpu`	Includes explicit objectness, class, and bbox branches.
YOLOHead	head	-	`unvalidated`	-	Generic YOLO name only; use validated family-specific rows.
RTMDetHead	dense	`rtmdet`, `rtmdet_head`	`runtime_validated`	`cpu`	Native RTMDet class and bbox branches.
SSDHead	dense	`ssd`, `ssd_head`, `ssd300`, `ssd512`, `ssdlite`	`runtime_validated`	`cpu`	Anchor-based SSD dense contract.
EfficientDetHead	dense	`efficientdet`, `efficientdet_head`	`runtime_validated`	`cpu`	Anchor-based EfficientDet head contract.
CenterNetHead	dense	`CenterNet`, `centernet_head`	`runtime_validated`	`cpu`	Keypoint heatmap head with dense compatibility outputs.
CornerNetHead	dense	`CornerNet`, `cornernet_head`	`runtime_validated`	`cpu`	Paired-corner heatmap head with embeddings and offsets.
SOLOV2Head	head	-	`unvalidated`	-	Registered name only; no supported instance segmentation claim.
Shared2FCBBoxHead	roi	`shared_2fc_bbox_head`, `shared2fc`	`runtime_validated`	`cpu`	Common two-FC ROI bbox head.
ConvFCBBoxHead	roi	`convfc_bbox_head`, `convfc`	`runtime_validated`	`cpu`	Configurable conv plus FC ROI bbox head.
DoubleConvFCBBoxHead	roi	`double_convfc_bbox_head`	`runtime_validated`	`cpu`	Double-head ROI bbox contract.
DynamicBBoxHead	roi	`dynamic_bbox_head`, `dynamic_bbox`	`runtime_validated`	`cpu`	Dynamic proposal feature mixing contract.
CascadeBBoxHead	roi	`cascade_bbox_head`, `cascade_bbox`	`runtime_validated`	`cpu`	Cascade stage refinement contract.
SABLHead	roi	`sabl_head`, `sabl_bbox_head`, `side_aware_bbox_head`	`runtime_validated`	`cpu`	Side-aware boundary localization ROI head.
SparseRoIHead	roi	`sparse_roi_head`, `sparse_bbox_head`, `sparse_rcnn_roi_head`	`runtime_validated`	`cpu`	Sparse R-CNN style learned proposal feature head.
FCNMaskHead	roi	`fcn_mask_head`, `fcn_mask`, `mask_head`	`runtime_validated`	`cpu`	FCN-style ROI mask head.
CascadeMaskHead	roi	`cascade_mask_head`, `cascade_mask`	`runtime_validated`	`cpu`	Cascade mask head contract.
GridHead	roi	`grid_head`, `grid_roi_head`	`runtime_validated`	`cpu`	Grid R-CNN ROI grid contract.
DETRHead	transformer	`DETR`, `detr_head`	`runtime_validated`	`cpu`	Query class and box predictions.
ConditionalDETRHead	transformer	`ConditionalDETR`, `conditional_detr_head`	`runtime_validated`	`cpu`	Conditional query content variant.
DABDETRHead	transformer	`DAB-DETR`, `dab_detr_head`	`runtime_validated`	`cpu`	Dynamic anchor box query variant.
DeformableDETRHead	transformer	`DeformableDETR`, `deformable_detr_head`	`runtime_validated`	`cpu`	Multi-scale transformer head with level embeddings.
DINOHead	transformer	`DINO`, `dino_head`	`runtime_validated`	`cpu`	Anchor and denoising query embeddings.

Backbone coverage

Native backbone aliases are planning metadata for TIMM-backed feature extraction. Install simpledet[cpu,timm] for runtime construction.

Backbone	Family	Aliases	Validation status	Required extra	Known limitation
timm	backbone	`TimmEncoder`, `timm:<model>`	`runtime_validated`	`cpu`, `timm`	Requires TIMM feature metadata at runtime.
resnet18	ResNet	`ResNet-18`, `r18`	`metadata_validated`	`cpu`, `timm`	Alias carries four-stage channel metadata.
resnet50	ResNet	`ResNet`, `ResNet-50`, `r50`	`metadata_validated`	`cpu`, `timm`	Alias carries four-stage channel metadata.
resnet101	ResNet	`ResNet-101`, `r101`	`metadata_validated`	`cpu`, `timm`	Alias carries four-stage channel metadata.
resnext50_32x4d	ResNeXt	`ResNeXt`, `ResNeXt-50`	`metadata_validated`	`cpu`, `timm`	Alias carries four-stage channel metadata.
res2net50_26w_4s	Res2Net	`Res2Net`, `Res2Net-50`	`metadata_validated`	`cpu`, `timm`	Alias carries four-stage channel metadata.
hrnet_w18	HRNet	`HRNet`, `HRNet-W18`, `hrnet18`	`metadata_validated`	`cpu`, `timm`	Alias carries multi-resolution stage metadata.
cspdarknet53	CSPDarkNet	`CSPDarkNet`, `CSPDarkNet-53`, `darknet53`	`metadata_validated`	`cpu`, `timm`	Alias carries four-stage channel metadata.
cspnext_tiny	CSPNeXt	`CSPNeXt`, `CSPNeXt-Tiny`	`metadata_validated`	`cpu`, `timm`	Alias carries four-stage channel metadata.
mobilenetv2_100	MobileNetV2	`MobileNetV2`	`metadata_validated`	`cpu`, `timm`	Alias carries four-stage channel metadata.
mobilenetv3_large_100	MobileNetV3	`MobileNetV3`, `MobileNetV3-Large`	`metadata_validated`	`cpu`, `timm`	Alias carries four-stage channel metadata.
efficientnet_b0	EfficientNet	`EfficientNet`, `EfficientNet-B0`	`metadata_validated`	`cpu`, `timm`	Default EfficientDet backbone alias.
convnext_tiny	ConvNeXt	`ConvNeXt`, `ConvNeXt-Tiny`	`runtime_validated`	`cpu`	Native ConvNeXt-Tiny backbone built from reusable CNN blocks.
swin_tiny_patch4_window7_224	Swin Transformer	`Swin`, `Swin Transformer`, `Swin-T`, `swin_tiny`	`metadata_validated`	`cpu`, `timm`	Alias carries four-stage channel metadata.
vit_base_patch16_224	Vision Transformer	`ViT`, `Vision Transformer`, `ViT-B/16`, `vit_base`	`metadata_validated`	`cpu`, `timm`	ViT stages share the configured channel width in current metadata.

Neck coverage

Neck	Kind	Aliases	Validation status	Required extra	Known limitation
FPN	neck	`fpn`	`runtime_validated`	`cpu`	Requires feature sequence channels to match the compiled plan.
ChannelMapper	neck	`channel_mapper`	`runtime_validated`	`cpu`	Projection-only neck for multiscale features.
PAN	neck	-	`runtime_validated`	`cpu`	Path aggregation FPN variant.
PANET	neck	`panet_neck`	`runtime_validated`	`cpu`	PANet naming variant.
BiFPN	neck	`bi_fpn`	`runtime_validated`	`cpu`	Bidirectional feature pyramid variant.
BiFPNV2	neck	`bi_fpn_v2`	`runtime_validated`	`cpu`	BiFPNv2 naming variant.
PAFPN	neck	`pa_fpn`	`runtime_validated`	`cpu`	Path aggregation FPN naming used by dense detectors.
NASFPN	neck	`nas_fpn`	`runtime_validated`	`cpu`	Repeated adjacent-level fusion; not a NAS search implementation.
FPNLite	neck	-	`runtime_validated`	`cpu`	Lightweight FPN naming variant.
FPNLiteNeck	neck	-	`runtime_validated`	`cpu`	Camel-case alias for lightweight FPN callers.
DilatedEncoder	neck	`dilated_encoder`	`runtime_validated`	`cpu`	YOLOF-style single-feature-level contract.
HRFPN	neck	`hr_fpn`	`runtime_validated`	`cpu`	HRNet-style multi-resolution feature fusion.
SSDNeck	neck	`ssd_neck`	`runtime_validated`	`cpu`	SSD projection and extra-level neck.
YOLOXPAFPN	neck	`yolox_pafpn`	`runtime_validated`	`cpu`	YOLOX path aggregation feature pyramid contract.

Not supported yet

DETR3D, DETRv2, Deformable DETR v2, Conditional DETR v2, DAB-DETR v2, and DINOv2 are planned, unsupported transformer variants. The builders reject them instead of silently routing them to another detector.
Legacy MMDetection config files under MyConfigs/, old notebooks, and historical study scripts are config-only references. They are not SimpleDet support evidence.
Rows marked compatibility_alias or unvalidated must not be presented as fully supported architecture-faithful implementations.