Catheter Robot Atlas

Get involved

Contribute

Add a robot, fix a number, or give us a picture you own. Every record is one YAML file; adding or fixing one is a pull request, checked automatically against the schema.

Ways to contribute

Add a robot

Any robot that pushes or twists a catheter or guidewire, or a device that bends its own tip, with at least one paper or product page. Open an issue with the form below, or send the YAML file as a pull request.

Fix a record

A wrong number, a missing version, a newer test level: change the field, cite the source key and section in the text, open a pull request. Every robot page has a "Suggest a correction" link.

Give a picture

A photo of your own robot under CC BY 4.0 replaces a placeholder. State the licence and the credit line you want.

Improve the schema

Need a field or a vocabulary value that does not exist? Propose it in the same pull request as the record that needs it.

Repository: GitHub [repository not created yet]

Add or fix a record

  1. Copy the template below to records/robots/<id>.yaml. The id is <shortname>_<firstauthor><year> in lower case, e.g. legobot_gao2026.
  2. Fill the fields from the papers. Required: schema_version, id, name, full_name, group, family, category, first_year, devices, translation_mechanism, rotation_mechanism, highest_validation, sim2real, picture, sources, read_level, maintainers_own. Vocabularies are listed in the docs.
  3. Validate: python3 tools/validate_records.py (needs pip install pyyaml jsonschema). It exits non-zero and names the file and field on any error.
  4. Preview: python3 tools/build_site.py --public, then cd site && python3 -m http.server 8000 and open http://localhost:8000.
  5. Submit a pull request with the YAML file (and a picture in records/pictures/ if you own it). The repository's checks run the validator and build the site.

While the catalogue is generated from the review's CSV, a maintainer copies an accepted change into the CSV, so it survives the next build.

Record template

# records/robots/<id>.yaml — one file per robot. Text fields keep the sources' words; write N.R. when a
# source does not report it; never estimate a number. Check: python3 tools/validate_records.py
schema_version: 1
id: ''
name: ''
full_name: ''
group: ''
group_short: ''
# family: commercial | academic | tip | magnetic
family: ''
# category: commercial | clinical-stage | academic | actuated-device | magnetic-navigation
category: ''
first_year: null
latest_year: null
versions: ''
target_anatomy: ''
# devices: guidewire | microcatheter | catheter | sheath | therapeutic-device | other | not-reported
devices: []
devices_driven: ''
n_dof: null
n_dof_detail: ''
# translation_mechanism: friction-roller | clamp-relay | belt/track | linear-stage+clamp | magnetic | tendon/tip-actuation | other | not-reported
translation_mechanism: ''
translation_detail: ''
# rotation_mechanism: rotating-clamp | rotating-drive-unit | roller-rolling | handle-rotation | tendon-bending | magnetic-field | none | other | not-reported
rotation_mechanism: ''
rotation_detail: ''
device_range: ''
footprint_mm: ''
mass_kg: ''
force_sensing: ''
haptics_leader: ''
imaging_compat: ''
sterility: ''
# highest_validation: bench | phantom | ex-vivo | animal | human
highest_validation: ''
validation_detail: ''
key_numbers: ''
sim_model: ''
has_sim_model: false
# sim2real: yes | partial | model-based | unclear | none-found
sim2real: ''
sim2real_detail: ''
picture:
  status: none        # cleared | not-cleared | none
  grade: none         # A | B | C | none
  kind: null          # photo | render | product-photo | clinical-photo | drawing
  source: ''          # paper key + figure, or page URL
  source_url: null
  licence: ''
  credit: ''
  edits: ''
  file: null          # pictures/<id>.jpg, only when cleared
pictures: []
sources:
- key: firstauthor2026_word
  doi: 10.xxxx/xxxxx
  url: null
  title: ''
  year: 2026
  venue: ''
# read_level: full | partial | abstract | web | secondary
read_level: ''
read_level_detail: ''
notes: ''
maintainers_own: false
# found_by: academic | commercial | actuated-tip | gap | contributor
found_by: ''

Field rules

  • Write what the source says, in its units, with the source key and section: stroke 300 mm (kantu2025_portable Sec. III-A).
  • A number the source does not report is N.R.. Never estimate or convert a number the source did not give.
  • One record per robot line: later versions of the same robot go into versions, oldest first.
  • highest_validation is the highest level reached by any version, and validation_detail says how many cases, animals or patients.
  • sim2real is yes only when a controller or model trained in simulation ran on this robot; cite the study.
  • read_level says honestly how deep the reading went: full text, part of it, abstract, web page, or a secondary source.
  • Every paper in sources has its DOI when one exists.

Pictures

A picture is published only when its licence allows reuse: Creative Commons Attribution (CC BY, without NC, ND or SA) or material of the maintainers' own lab; the rule is licence_ok() in tools/licence_rule.py. Any other picture (publisher copyright, press images, NC/ND licences) stays at its source and the record links to it. Pictures are resized to 800 px on the long side; list every change you made in picture.edits (CC BY asks for that).

Pull request checklist

  • One robot per file; file name = id + .yaml.
  • python3 tools/validate_records.py passes.
  • Every number has its source key and section; unreported values are N.R..
  • Every source has a DOI or a link.
  • A picture, if added, is yours or CC BY, with licence, credit and edits filled.
  • If you built the robot, say so in the pull request.

Issue form: new robot

The repository's issue form (.github/ISSUE_TEMPLATE/new-robot.yml) asks for the following; by e-mail, the same list works.

Robot name and short description:
Developer (lab, university or company):
First paper (DOI) and later versions (DOIs):
Devices driven (guidewire / catheter / microcatheter / sheath / balloon-stent), sizes:
Push mechanism (friction rollers / clamp relay / belt / linear stage / magnetic / tip-actuated / other):
Twist mechanism:
Degrees of freedom:
Highest test level (bench / phantom / ex vivo / animal / human) and the paper that reports it:
A picture you own or one under CC BY (link and licence), if any:
Your relation to the robot (developer / user / reader):