manim-radar 0.1.0__tar.gz

manim_radar-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+venv/
+.pytest_cache/
+.DS_Store
+media/
+
+# manim caches / local renders
+*.mp4
+!docs/*.gif

manim_radar-0.1.0/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+All notable changes to `manim-radar` are documented here.
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
+and the project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] — 2026-09-21
+
+First release.
+
+### Added
+
+- `RadarChart` — an animated radar/spider chart as a real Manim `VGroup`
+  (supports `shift` / `move_to` / `scale` / `rotate` / `FadeIn` / `FadeOut`).
+- `RadarData` — immutable snapshot model with axes, values, name, colour,
+  full scale, emphasis, hold and per-snapshot transition overrides.
+- `RadarChart.morph_to(...)` — one command tweens values, full scale, colour,
+  emphasis outline, opacity and nameplate in a single pass.
+- Six transition presets: `smooth`, `dip`, `shockwave`, `zoom`, `glitch`, `stepped`.
+- `RadarReel` — plays a whole list of snapshots (with black gaps) in one call.
+- `RadarReveal`, `RadarFade`, `GlitchFlash` and `Shockwave` animations.
+- `RollingNumber` — odometer-style value read-out with overflow labels (`10+`).
+- `DeepSpace` — radial glow + corner vignette + nebula blobs + drifting stars,
+  tinted by the chart colour.
+- Three style presets (`neo`, `classic`, `minimal`) and five themes
+  (`midnight`, `aurora`, `ember`, `violet`, `paper`).
+- `RadarConfig` (~60 fields) and `RadarTheme` for full customisation.
+- Legacy generations rebuilt on the library: `RadarV1Scene` (1.0) and
+  `RadarV2Scene` (2.0), playing the bundled 23-snapshot demo reel.
+- Cross-platform font fallback (`PingFang SC` → `Microsoft YaHei` → `Noto Sans CJK` …).
+- `manim-radar` CLI: `themes`, `styles`, `template`, `demo --render`.
+- Manim plugin entry point (`manim.plugins`) and example scenes under `examples/`.
+- Test suite (41 tests) that runs without rendering.
+
+[Unreleased]: https://github.com/FTZ-OPUS/manim-radar/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/FTZ-OPUS/manim-radar/releases/tag/v0.1.0

manim_radar-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FTZ-OPUS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

manim_radar-0.1.0/PKG-INFO

@@ -0,0 +1,272 @@
+Metadata-Version: 2.5
+Name: manim_radar
+Version: 0.1.0
+Summary: Animated radar (spider) charts for Manim — build, morph and play whole radar-chart sequences with one line of code.
+Project-URL: Homepage, https://github.com/FTZ-OPUS/manim-radar
+Project-URL: Repository, https://github.com/FTZ-OPUS/manim-radar
+Project-URL: Issues, https://github.com/FTZ-OPUS/manim-radar/issues
+Project-URL: Changelog, https://github.com/FTZ-OPUS/manim-radar/blob/main/CHANGELOG.md
+Author-email: FTZ-OPUS <1710644976@qq.com>
+License: MIT
+License-File: LICENSE
+Keywords: animation,data-visualization,education,manim,manim-plugin,morph,radar-chart,spider-chart,web-chart
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.9
+Requires-Dist: manim>=0.18
+Requires-Dist: numpy>=1.23
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: pillow>=9.5; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# manim-radar
+
+**Animated radar (spider) charts for [Manim](https://www.manim.community/) — build one, morph it into another, or play a whole sequence with a single command.**
+
+[![PyPI](https://img.shields.io/pypi/v/manim-radar?color=17b8ba)](https://pypi.org/project/manim-radar/)
+[![Python](https://img.shields.io/pypi/pyversions/manim-radar)](https://pypi.org/project/manim-radar/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![CI](https://github.com/FTZ-OPUS/manim-radar/actions/workflows/ci.yml/badge.svg)](https://github.com/FTZ-OPUS/manim-radar/actions/workflows/ci.yml)
+
+![demo](https://raw.githubusercontent.com/FTZ-OPUS/manim-radar/main/docs/demo.gif)
+
+```python
+from manim import *
+from manim_radar import RadarChart, DeepSpace, set_scene_background
+
+AXES = ["Speed", "Power", "Range", "Comfort", "Price", "Safety"]
+
+class Demo(Scene):
+    def construct(self):
+        set_scene_background("midnight")
+        chart = RadarChart(axes=AXES, values=[8, 6, 7, 9, 5, 8], title="Six axes")
+
+        self.add(DeepSpace().link(chart))              # optional starfield
+        self.play(chart.reveal())                      # grow out of the centre
+        self.play(chart.morph_to([5, 9, 5, 6, 9, 9],   # one command = one morph
+                                 color="#FFB74D"))
+        self.play(chart.disappear())
+```
+
+```bash
+manim -qh demo.py Demo          # 1080p60
+```
+
+---
+
+## Install
+
+```bash
+pip install manim_radar
+```
+
+Requires Python ≥ 3.9, `manim >= 0.18` and `numpy`. `pip` pulls those in for you.
+
+## Features
+
+| | |
+|---|---|
+| **One command morphing** | `chart.morph_to(...)` tweens values, full scale, colour, emphasis outline and opacity in a single pass |
+| **Six transition presets** | `smooth`, `dip`, `shockwave`, `zoom`, `glitch`, `stepped` — plus every knob to fine-tune them |
+| **One command sequences** | `RadarReel(chart, snapshots).play_on(self)` plays a whole reel, black gaps included |
+| **3 styles × 5 themes** | `neo` (glow / rainbow outline / sweep beam), `classic` (the lean 1.0 look), `minimal` (light themes, reports) |
+| **Odometer numbers** | digits roll continuously instead of snapping, with automatic `10+` overflow labels |
+| **Real Manim mobjects** | the chart is a `VGroup`: `shift` / `move_to` / `scale` / `rotate` / `FadeIn` / `FadeOut` all behave |
+| **Deep-space backdrop** | `DeepSpace` adds a radial glow, corner vignette, nebula blobs and drifting stars that tint with the chart |
+| **Two generations included** | `RadarV1Scene` and `RadarV2Scene` rebuild the original 1.0 and 2.0 reels from the library |
+| **Cross-platform fonts** | picks the first installed CJK / monospace font, works on macOS, Linux and Windows |
+
+## Demos
+
+Every GIF below was rendered straight from the matching example scene
+(`manim -ql` + `ffmpeg`); they all live in [`docs/`](docs/).
+
+| | |
+|---|---|
+| ![quickstart](https://raw.githubusercontent.com/FTZ-OPUS/manim-radar/main/docs/quickstart.gif) | **Quickstart** — build → reveal → morph → fade, in ten lines. `examples/01_quickstart.py` |
+| ![transitions](https://raw.githubusercontent.com/FTZ-OPUS/manim-radar/main/docs/demo.gif) | **Transitions** — smooth / shockwave / zoom / glitch / rim. `examples/02_morph_gallery.py` |
+| ![reel](https://raw.githubusercontent.com/FTZ-OPUS/manim-radar/main/docs/reel.gif) | **One-command reel** — a whole sequence, black gap included. `examples/03_reel.py` |
+| ![styles and themes](https://raw.githubusercontent.com/FTZ-OPUS/manim-radar/main/docs/styles.gif) | **3 styles × 5 themes** — from `neo` glow to a light `paper` report. `examples/04_styles_themes.py` |
+| ![classic vs neo](https://raw.githubusercontent.com/FTZ-OPUS/manim-radar/main/docs/classic-vs-neo.gif) | **The two generations** — classic (1.0) vs neo (2.0), same data. `examples/05_two_styles.py` |
+
+## The three objects
+
+```python
+from manim_radar import RadarChart, RadarData, RadarReel
+```
+
+**`RadarData`** — one snapshot: the axes and the value on each of them.
+
+```python
+RadarData(
+    axes=["A", "B", "C", "D", "E", "F"],
+    values=[8, 6, 7, 9, 5, 8],
+    name="Model A",        # optional nameplate (morphed on every transition)
+    color="#17B8BA",       # optional main colour (else the theme palette cycles)
+    max_value=10,          # optional full scale; above it values render as "10+"
+    emphasis="rim",        # "zoom" | "gap" | "rim" — used by RadarReel
+    hold=0.6,              # seconds to hold on this snapshot (RadarReel)
+    transition="glitch",   # per snapshot transition override
+)
+```
+
+**`RadarChart`** — the mobject.
+
+```python
+chart = RadarChart(data_or_axes=..., style="neo", theme="midnight", radius=3.2)
+
+chart.set_values([1, 2, 3, 4, 5, 6])   # instant, no animation
+chart.set_main_color("#E868C8")
+chart.set_rim(1.0)                     # orange/cyan emphasis outline
+chart.set_radius(2.4)
+chart.attach_backdrop(self)            # shortcut for DeepSpace().link(chart)
+
+self.play(chart.reveal())              # intro
+self.play(chart.morph_to(other))       # the money shot
+self.play(chart.glitch_in())           # glitchy re-entrance
+self.play(chart.disappear())           # outro
+```
+
+**`RadarReel`** — the whole sequence in one line.
+
+```python
+RadarReel(
+    chart,
+    snapshots=[d1, d2, d3, d4],   # list[RadarData]
+    hold=0.6,                     # default hold per snapshot
+    transition="shockwave",       # default transition
+    backdrop=True,                # starfield, auto-tinted
+    gap_hold=1.5,                 # length of a snapshot's "gap" black-out
+).play_on(self)
+```
+
+## Transitions
+
+| `transition=` | What it does |
+|---|---|
+| `None` *(default)* | dip below the target, then roll up (the signature `neo` move) |
+| `"smooth"` | straight tween, no dip |
+| `"shockwave"` | dip + an expanding ring that covers the shape change |
+| `"zoom"` | shockwave + zoom & dim, then snap back (the "big transition") |
+| `"glitch"` | chromatic split + flicker while the values change |
+| `"stepped"` | values snap in integer steps (the `classic` feel) |
+
+```python
+self.play(chart.morph_to(target, transition="zoom", run_time=1.6))
+```
+
+## Styles and themes
+
+```python
+chart = RadarChart(data, style="neo",       theme="midnight")
+RadarChart(data, style="classic")           # the 1.0 look
+RadarChart(data, style="minimal", theme="paper")   # light background
+```
+
+* **Styles** change *structure*: `neo`, `classic`, `minimal` (see `STYLES`).
+* **Themes** change *colours*: `midnight`, `aurora`, `ember`, `violet`, `paper`.
+
+Everything is a dataclass, so you can start from a preset and tweak:
+
+```python
+from manim_radar import RadarChart, RadarConfig, RadarTheme
+
+cfg = RadarConfig(radius=2.4, levels=4, numbers="swap", sweep=False, rainbow_edges=False)
+theme = RadarTheme(name="mine", grid="#8899AA", axis_colors=("#5EEAD4", "#F0ABFC") * 3)
+chart = RadarChart(data, config=cfg, theme=theme)
+```
+
+`RadarConfig()` has ~60 documented fields: geometry, grid, polygon layers, fonts and
+sizes, decorations, transition timings, title/nameplate placement. `RadarTheme`
+holds every colour (grid, per-axis colours, palette, rims, star accents…).
+
+## Reuse inside a bigger scene
+
+Reveal a chart, then morph it while you write something else beside it:
+
+```python
+chart = RadarChart(AXES_DATA, radius=2.2)
+chart.move_to(LEFT * 3.4)
+self.play(chart.reveal())
+self.play(chart.morph_to(next_data), Write(my_formula))
+```
+
+Because the chart is a plain `VGroup` whose geometry is recomputed in its own
+coordinate frame every frame, moving or scaling it never breaks the drawing.
+
+## Backdrop
+
+```python
+from manim_radar import DeepSpace, set_scene_background
+
+set_scene_background("midnight")           # flat background colour of the theme
+backdrop = DeepSpace(theme="midnight", star_count=80, nebula_count=8)
+backdrop.link(chart)                       # nebula / halos follow the chart colour
+self.add(backdrop)
+```
+
+## The two generations
+
+Both original looks ship as ready-to-run scenes, built on the same library:
+
+```bash
+manim -qh examples/legacy_v1.py RadarV1Scene   # 1.0 : lean grid, snap-in numbers
+manim -qh examples/legacy_v2.py RadarV2Scene   # 2.0 : glow, rainbow outline, shockwaves
+```
+
+They play the bundled 23-snapshot demo reel (`manim_radar.legacy.REPLICA_TIMELINE`).
+
+## CLI
+
+```bash
+manim-radar --version
+manim-radar themes                  # list colour themes
+manim-radar styles                  # list style presets
+manim-radar template my_chart.py    # write a starter scene
+manim-radar demo --render           # render the bundled demo reel
+```
+
+## Rendering
+
+```bash
+manim -ql scene.py MyScene      # 480p15, fast preview
+manim -qh scene.py MyScene      # 1080p60, final
+```
+
+If you are driving Manim from another tool, pass `--media_dir` to keep the render
+cache out of your source tree.
+
+## Publishing notes
+
+The package is a standard PEP 621 project using **hatchling**:
+
+```bash
+python -m build            # -> dist/manim_radar-<version>-py3-none-any.whl + .tar.gz
+twine check dist/*         # optional sanity check
+twine upload dist/*        # or use the Release workflow (PyPI Trusted Publishing)
+```
+
+The distribution is registered as a Manim plugin (`manim.plugins` entry point), so
+`manim plugins` lists it once installed.
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+---
+
+Also by the same author: [`manim-handdraw`](https://github.com/FTZ-OPUS/manim-handdraw)
+(turn line art into progressive hand-drawn animation).

manim_radar-0.1.0/README.md

@@ -0,0 +1,238 @@
+# manim-radar
+
+**Animated radar (spider) charts for [Manim](https://www.manim.community/) — build one, morph it into another, or play a whole sequence with a single command.**
+
+[![PyPI](https://img.shields.io/pypi/v/manim-radar?color=17b8ba)](https://pypi.org/project/manim-radar/)
+[![Python](https://img.shields.io/pypi/pyversions/manim-radar)](https://pypi.org/project/manim-radar/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![CI](https://github.com/FTZ-OPUS/manim-radar/actions/workflows/ci.yml/badge.svg)](https://github.com/FTZ-OPUS/manim-radar/actions/workflows/ci.yml)
+
+![demo](https://raw.githubusercontent.com/FTZ-OPUS/manim-radar/main/docs/demo.gif)
+
+```python
+from manim import *
+from manim_radar import RadarChart, DeepSpace, set_scene_background
+
+AXES = ["Speed", "Power", "Range", "Comfort", "Price", "Safety"]
+
+class Demo(Scene):
+    def construct(self):
+        set_scene_background("midnight")
+        chart = RadarChart(axes=AXES, values=[8, 6, 7, 9, 5, 8], title="Six axes")
+
+        self.add(DeepSpace().link(chart))              # optional starfield
+        self.play(chart.reveal())                      # grow out of the centre
+        self.play(chart.morph_to([5, 9, 5, 6, 9, 9],   # one command = one morph
+                                 color="#FFB74D"))
+        self.play(chart.disappear())
+```
+
+```bash
+manim -qh demo.py Demo          # 1080p60
+```
+
+---
+
+## Install
+
+```bash
+pip install manim_radar
+```
+
+Requires Python ≥ 3.9, `manim >= 0.18` and `numpy`. `pip` pulls those in for you.
+
+## Features
+
+| | |
+|---|---|
+| **One command morphing** | `chart.morph_to(...)` tweens values, full scale, colour, emphasis outline and opacity in a single pass |
+| **Six transition presets** | `smooth`, `dip`, `shockwave`, `zoom`, `glitch`, `stepped` — plus every knob to fine-tune them |
+| **One command sequences** | `RadarReel(chart, snapshots).play_on(self)` plays a whole reel, black gaps included |
+| **3 styles × 5 themes** | `neo` (glow / rainbow outline / sweep beam), `classic` (the lean 1.0 look), `minimal` (light themes, reports) |
+| **Odometer numbers** | digits roll continuously instead of snapping, with automatic `10+` overflow labels |
+| **Real Manim mobjects** | the chart is a `VGroup`: `shift` / `move_to` / `scale` / `rotate` / `FadeIn` / `FadeOut` all behave |
+| **Deep-space backdrop** | `DeepSpace` adds a radial glow, corner vignette, nebula blobs and drifting stars that tint with the chart |
+| **Two generations included** | `RadarV1Scene` and `RadarV2Scene` rebuild the original 1.0 and 2.0 reels from the library |
+| **Cross-platform fonts** | picks the first installed CJK / monospace font, works on macOS, Linux and Windows |
+
+## Demos
+
+Every GIF below was rendered straight from the matching example scene
+(`manim -ql` + `ffmpeg`); they all live in [`docs/`](docs/).
+
+| | |
+|---|---|
+| ![quickstart](https://raw.githubusercontent.com/FTZ-OPUS/manim-radar/main/docs/quickstart.gif) | **Quickstart** — build → reveal → morph → fade, in ten lines. `examples/01_quickstart.py` |
+| ![transitions](https://raw.githubusercontent.com/FTZ-OPUS/manim-radar/main/docs/demo.gif) | **Transitions** — smooth / shockwave / zoom / glitch / rim. `examples/02_morph_gallery.py` |
+| ![reel](https://raw.githubusercontent.com/FTZ-OPUS/manim-radar/main/docs/reel.gif) | **One-command reel** — a whole sequence, black gap included. `examples/03_reel.py` |
+| ![styles and themes](https://raw.githubusercontent.com/FTZ-OPUS/manim-radar/main/docs/styles.gif) | **3 styles × 5 themes** — from `neo` glow to a light `paper` report. `examples/04_styles_themes.py` |
+| ![classic vs neo](https://raw.githubusercontent.com/FTZ-OPUS/manim-radar/main/docs/classic-vs-neo.gif) | **The two generations** — classic (1.0) vs neo (2.0), same data. `examples/05_two_styles.py` |
+
+## The three objects
+
+```python
+from manim_radar import RadarChart, RadarData, RadarReel
+```
+
+**`RadarData`** — one snapshot: the axes and the value on each of them.
+
+```python
+RadarData(
+    axes=["A", "B", "C", "D", "E", "F"],
+    values=[8, 6, 7, 9, 5, 8],
+    name="Model A",        # optional nameplate (morphed on every transition)
+    color="#17B8BA",       # optional main colour (else the theme palette cycles)
+    max_value=10,          # optional full scale; above it values render as "10+"
+    emphasis="rim",        # "zoom" | "gap" | "rim" — used by RadarReel
+    hold=0.6,              # seconds to hold on this snapshot (RadarReel)
+    transition="glitch",   # per snapshot transition override
+)
+```
+
+**`RadarChart`** — the mobject.
+
+```python
+chart = RadarChart(data_or_axes=..., style="neo", theme="midnight", radius=3.2)
+
+chart.set_values([1, 2, 3, 4, 5, 6])   # instant, no animation
+chart.set_main_color("#E868C8")
+chart.set_rim(1.0)                     # orange/cyan emphasis outline
+chart.set_radius(2.4)
+chart.attach_backdrop(self)            # shortcut for DeepSpace().link(chart)
+
+self.play(chart.reveal())              # intro
+self.play(chart.morph_to(other))       # the money shot
+self.play(chart.glitch_in())           # glitchy re-entrance
+self.play(chart.disappear())           # outro
+```
+
+**`RadarReel`** — the whole sequence in one line.
+
+```python
+RadarReel(
+    chart,
+    snapshots=[d1, d2, d3, d4],   # list[RadarData]
+    hold=0.6,                     # default hold per snapshot
+    transition="shockwave",       # default transition
+    backdrop=True,                # starfield, auto-tinted
+    gap_hold=1.5,                 # length of a snapshot's "gap" black-out
+).play_on(self)
+```
+
+## Transitions
+
+| `transition=` | What it does |
+|---|---|
+| `None` *(default)* | dip below the target, then roll up (the signature `neo` move) |
+| `"smooth"` | straight tween, no dip |
+| `"shockwave"` | dip + an expanding ring that covers the shape change |
+| `"zoom"` | shockwave + zoom & dim, then snap back (the "big transition") |
+| `"glitch"` | chromatic split + flicker while the values change |
+| `"stepped"` | values snap in integer steps (the `classic` feel) |
+
+```python
+self.play(chart.morph_to(target, transition="zoom", run_time=1.6))
+```
+
+## Styles and themes
+
+```python
+chart = RadarChart(data, style="neo",       theme="midnight")
+RadarChart(data, style="classic")           # the 1.0 look
+RadarChart(data, style="minimal", theme="paper")   # light background
+```
+
+* **Styles** change *structure*: `neo`, `classic`, `minimal` (see `STYLES`).
+* **Themes** change *colours*: `midnight`, `aurora`, `ember`, `violet`, `paper`.
+
+Everything is a dataclass, so you can start from a preset and tweak:
+
+```python
+from manim_radar import RadarChart, RadarConfig, RadarTheme
+
+cfg = RadarConfig(radius=2.4, levels=4, numbers="swap", sweep=False, rainbow_edges=False)
+theme = RadarTheme(name="mine", grid="#8899AA", axis_colors=("#5EEAD4", "#F0ABFC") * 3)
+chart = RadarChart(data, config=cfg, theme=theme)
+```
+
+`RadarConfig()` has ~60 documented fields: geometry, grid, polygon layers, fonts and
+sizes, decorations, transition timings, title/nameplate placement. `RadarTheme`
+holds every colour (grid, per-axis colours, palette, rims, star accents…).
+
+## Reuse inside a bigger scene
+
+Reveal a chart, then morph it while you write something else beside it:
+
+```python
+chart = RadarChart(AXES_DATA, radius=2.2)
+chart.move_to(LEFT * 3.4)
+self.play(chart.reveal())
+self.play(chart.morph_to(next_data), Write(my_formula))
+```
+
+Because the chart is a plain `VGroup` whose geometry is recomputed in its own
+coordinate frame every frame, moving or scaling it never breaks the drawing.
+
+## Backdrop
+
+```python
+from manim_radar import DeepSpace, set_scene_background
+
+set_scene_background("midnight")           # flat background colour of the theme
+backdrop = DeepSpace(theme="midnight", star_count=80, nebula_count=8)
+backdrop.link(chart)                       # nebula / halos follow the chart colour
+self.add(backdrop)
+```
+
+## The two generations
+
+Both original looks ship as ready-to-run scenes, built on the same library:
+
+```bash
+manim -qh examples/legacy_v1.py RadarV1Scene   # 1.0 : lean grid, snap-in numbers
+manim -qh examples/legacy_v2.py RadarV2Scene   # 2.0 : glow, rainbow outline, shockwaves
+```
+
+They play the bundled 23-snapshot demo reel (`manim_radar.legacy.REPLICA_TIMELINE`).
+
+## CLI
+
+```bash
+manim-radar --version
+manim-radar themes                  # list colour themes
+manim-radar styles                  # list style presets
+manim-radar template my_chart.py    # write a starter scene
+manim-radar demo --render           # render the bundled demo reel
+```
+
+## Rendering
+
+```bash
+manim -ql scene.py MyScene      # 480p15, fast preview
+manim -qh scene.py MyScene      # 1080p60, final
+```
+
+If you are driving Manim from another tool, pass `--media_dir` to keep the render
+cache out of your source tree.
+
+## Publishing notes
+
+The package is a standard PEP 621 project using **hatchling**:
+
+```bash
+python -m build            # -> dist/manim_radar-<version>-py3-none-any.whl + .tar.gz
+twine check dist/*         # optional sanity check
+twine upload dist/*        # or use the Release workflow (PyPI Trusted Publishing)
+```
+
+The distribution is registered as a Manim plugin (`manim.plugins` entry point), so
+`manim plugins` lists it once installed.
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+---
+
+Also by the same author: [`manim-handdraw`](https://github.com/FTZ-OPUS/manim-handdraw)
+(turn line art into progressive hand-drawn animation).