#MoonPlot

#Features

• Everyday charts: line, scatter, bar, histogram, pie, box, and violin plots.
• Scientific plots: error bars, filled regions, contours, triangulated meshes, vector fields, and stream plots.
• Images and color: scalar and RGB(A) images, heatmaps, color maps, normalization, masks, and colorbars.
• Figure composition: multiple axes, shared axes, nested grids, secondary axes, titles, labels, legends, tables, and annotations.
• Axes and data: numeric scales, explicit ticks and formatters, date/time coordinates, time zones, and categorical labels.
• Editable lines: data updates, visibility, color, alpha, line width, draw styles, dashes, and gap colors through Line2D handles.
• SVG output: render a figure to a string without a Python runtime.
• Rabbita components: an optional JS adapter provides real SVG DOM nodes, point hover and selection, legend buttons, reactive data updates, and scoped SVG resources.

#Getting Started

moon add Lampese/mathplotlib@0.2.1

#Run the repository examples

git clone https://github.com/moonbit-community/moonplot.git
cd moonplot
moon run cmd/preview --target native > chart.svg
moon build rabbita/cmd/demo --target js
python3 -m http.server 8765 --bind 127.0.0.1

#Library Usage

///|
import {
  "Lampese/mathplotlib",
}

///|
fn main raise {
  let fig = @mathplotlib.figure(width=640, height=400)
  fig.set_title("A MoonPlot chart")
  fig.set_x_label("Sample")
  fig.set_y_label("Value")
  fig.set_x_limits(0.0, 4.0)
  fig.set_y_limits(0.0, 20.0)
  fig.set_x_ticks([0.0, 1.0, 2.0, 3.0, 4.0])
  fig.set_y_ticks([0.0, 5.0, 10.0, 15.0, 20.0])
  fig.set_x_tick_labels(["0", "1", "2", "3", "4"])
  fig.set_y_tick_labels(["0", "5", "10", "15", "20"])
  fig.plot(
    [0.0, 1.0, 2.0, 3.0, 4.0],
    [3.0, 7.0, 5.0, 13.0, 17.0],
    color="#2563eb",
    label="Measurements",
  )
  fig.legend(fig.legend_entries())
  println(fig.to_svg_checked())
}

#Gallery and legend placement

moon run cmd/gallery --target native > gallery.svg

#Interactive Rabbita components

///|
import {
  "Lampese/mathplotlib",
  "Lampese/mathplotlib/rabbita" @plot_dom,
  "moonbit-community/rabbita",
}

#Current scope

• SVG is the static output backend; Rabbita DOM is an optional browser component. Standalone PNG/PDF export and a desktop GUI backend are not available.
• Interactive picking currently covers line/scatter data-point anchors. Touch gestures, zoom/pan, and keyboard navigation remain future work.
• 3D plotting, animation, and full mathtext/TeX and font layout are not available.
• The library is not a drop-in Matplotlib implementation. Python's dynamic argument forms and every chart parameter are not reproduced.
• SVG text uses the viewer's fonts; full text measurement and typography remain limited.

#Documentation

• Documentation index
• Detailed usage and API examples
• Current capabilities and milestone acceptance
• Installation, module paths and release status
• M2 interactive plotting and source-release history
• Four capability goals
• Rabbita interactive DOM and acceptance
• Dependencies and integration notes
• Third-party licenses and attribution

#Development

python3 tools/check_structure.py
moon check --target all
moon test --target all
moon info
moon fmt

#License