Logo

Getting Started

  • Installation
    • Requirements
    • Installation from PyPI
    • Keeping DISCO up to date
    • Included Static Assets
  • Quick Start
    • Interactive GUI Mode
    • Automated CLI Mode

User Guide

  • Architecture
    • Repository Structure
    • Module Relationships
    • Operational Modes
      • CLI Pipeline (disco-start <identifier ...>)
      • GUI Server (disco-start gui)
    • Frontend Build Pipeline
  • Pipeline Description
    • Group Discovery
    • Phase 1 — FITS Ingestion
    • Phase 2 — Geometry Optimisation
    • Phase 3 — Uncertainty Estimation
    • Phase 4 — Profile Extraction and Beam Homogenisation
    • Phase 5 — Output Serialisation
  • Command-Line Interface
    • Synopsis
    • Positional Arguments
    • Optional Arguments
    • Usage Examples
    • CNN Model Loading
  • Graphical User Interface
    • Step-by-Step Guide
    • Application Layout
    • File Loading
    • Toolbar Reference
    • Geometry Controls (CONTROLS panel)
    • Auto-Tune Geometry
    • Analysis Dashboard (ANALYSIS panel)
      • View Modes
      • Display Settings
      • 1D Profile Chart
      • Cursor Probe
      • Ring Fit Statistics
      • Cumulative Flux Chart
      • Custom Markers
    • Export Functions
    • SIMBAD Query

API Reference

  • disco.core.fits_utils
    • Beam Utilities
      • get_alma_beam()
      • deconvolve_beams()
      • make_gaussian_kernel_casa()
    • Centroid and Parameter Detection
      • find_center_robust()
      • auto_detect_parameters()
      • refine_center_local()
    • Profile Extraction
      • extract_profile()
      • measure_rout_deproj()
      • save_debug_deproj_center()
    • WCS and Coordinate Utilities
      • deg_to_sex()
      • pixel_to_icrs()
      • icrs_to_pixel()
      • get_obs_epoch()
    • Gaia Proper Motion
      • query_gaia_proper_motion()
      • apply_proper_motion_correction()
  • disco.core.cnn_inference
    • Architecture
      • ResBlock
        • ResBlock.forward()
      • DiscoNet
        • DiscoNet.forward()
    • Output Encoding
    • Inference Function
      • predict_with_cnn()
  • disco.core.optimization
    • Geometric Loss Function
      • geometric_loss()
    • Hybrid Geometry Optimiser
      • auto_tune_geometry_hybrid()
    • Uncertainty Estimation
      • estimate_geometry_errors()
    • Centre Refinement
      • refine_center_geometry()
  • disco.server — HTTP API Reference
    • Global State
    • Pydantic Request Models
      • PlotParams
      • PipelineParams
      • OptimizeParams
      • LoadLocalParams
    • Endpoints
      • Session Management
      • File Loading
      • Pipeline and Optimisation
      • Rendering
      • Download and Metadata
      • Static File Serving
    • Server Lifecycle
      • start_server()
  • disco.cli
    • discover_groups()
    • run_pipeline()
    • main()
  • disco.main
    • run()

Supplementary

  • DiscoNet Training Pipeline
    • Step 1: Catalogue Generation (training/generate_catalogue.py)
    • Step 2: FITS Simulation (training/simulate_catalogue.py)
    • Step 3: Model Training (training/train_model.py)
  • File Input and Output
    • FITS Input
    • CLI Output Files
      • Radial Profile Plot
      • CSV Exports (--csv on)
      • Debug Output (--debug on)
    • GUI Session Files
    • GUI FITS Downloads
    • GUI CSV Export
  • Changelog
    • Version 1.2.3 (current)
DISCO
  • Overview: module code

All modules for which code is available

  • disco.cli
  • disco.core.cnn_inference
  • disco.core.fits_utils
  • disco.core.optimization
  • disco.main
  • disco.server

© Copyright 2026, Jorge Luis Guzmán-Lazo.

Built with Sphinx using a theme provided by Read the Docs.