simula-logo project

Version 2

This repository is the workspace for Simula logo generation assets and code. Version 2 adds a browser-based SVG editor alongside the existing Python-based Penrose tiling generator, so the project now covers both logo generation and direct post-generation editing.

Repository layout

• assets/: generated and source artwork assets
• tools/svg-editor/: browser app for loading, selecting, editing, and exporting Simula SVG artwork
• tools/simula-logo-generator/: logo-specific Python package and CLI documentation
• tools/mosaic/: PNG-to-SVG mosaic colouring package and CLI
• packages/penrose/: reusable Penrose tiling geometry package
• examples/: standalone Python examples and rendered outputs
• tests/: pytest smoke tests for imports, SVG generation, and CLI behavior

Version 2 overview

Version 2 introduces the interactive SVG editor under tools/svg-editor/.

At a high level, the editor supports:

• loading an SVG from disk or opening the bundled sample
• selecting panels by click, drag, rectangular marquee selection, or invert selection
• editing fill and edge styling for the current selection
• auto-applying fill color changes when panels are selected
• deleting selected panels
• deleting selected panels with the toolbar or keyboard
• undo and redo for editor operations
• exporting the edited SVG back to disk

Detailed editor usage, controls, and local run instructions live in tools/svg-editor/README.md.

Python generator

The Python implementation is documented in tools/simula-logo-generator/README.md.

Install the Python tools from the repository root:

python3 -m pip install .

This installs the generate_simula_logo, svg_png_mosaic,penrose-mcp, simula-logo-generator-mcp, and svg-png-mosaic-mcp commands and the simula_logo_generator, mosaic, and penrose Python packages.

The Codex MCP config exposes:

• penrose: generate_penrose_p3_artwork
• simula-logo-generator: generate_simula_logo_artwork
• mosaic: color_svg_from_png

Current status

The Python package now has:

• a stable public import surface for penrose, mosaic, and simula_logo_generator
• MCP entry points for Penrose P3 artwork, Simula logo generation, and PNG-to-SVG mosaic colouring
• smoke tests for imports, SVG generation, and CLI argument propagation
• examples that use the supported package imports

Additional repo-level assets and tooling can be documented here as they are added.