How cartographer3d/cartographer3d-plugin works
Project type and purpose
• Cartographer3D is a Python-based tool for 3D-printer probing, mesh generation, and calibration.
• It provides a CLI/library (“cartographer” entrypoint) that drives a printer via adapter layers (Klipper or Kalico), collects probe data, runs filters/integrators, and produces bed meshes or Z-offset calibrations.
File structure
• Top-level:
• scripts/ – helper scripts (e.g. install.sh, path plotting)
• src/cartographer/ – main package
• tests/ – unit and BDD tests
• pyproject.toml, hatch_build.py – build configuration
• src/cartographer/ layers:
• adapters/ – hardware-specific communication (klipper, kalico)
• config/ – command-line and file parser
• core.py – central orchestration
• interfaces/ – abstract interfaces (printer, multiprocessing)
• lib/ – utility algorithms (filters, NN, stats, logging)
• macros/ – high-level workflows (bed_mesh, probe, touch, calibrate)
• probe/ – data models and probe logic
• runtime/ – dynamic loader, environment setup, integrator runtime
• stream.py, toolhead.py – shared stream and toolhead abstractions
README for additional insights
• It’s in beta (Cartographer3D WIP)
• Documentation lives externally
– “Runtime Loader & Environment”
– “Macro Engine”