https://github.com/bilgesucakir/stitch-grapher
Java-based crochet pattern engine for topology-aware parsing, stitch connectivity graph modeling, and visualization.
https://github.com/bilgesucakir/stitch-grapher
crochet-pattern cytoscape data-structures domain-modeling dsl graph graph-theory graph-visualization java oop parser parsing spring-boot threejs topology
Last synced: 12 days ago
JSON representation
Java-based crochet pattern engine for topology-aware parsing, stitch connectivity graph modeling, and visualization.
- Host: GitHub
- URL: https://github.com/bilgesucakir/stitch-grapher
- Owner: bilgesucakir
- License: mit
- Created: 2026-05-09T14:39:40.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-26T14:00:11.000Z (17 days ago)
- Last Synced: 2026-05-26T15:31:11.643Z (17 days ago)
- Topics: crochet-pattern, cytoscape, data-structures, domain-modeling, dsl, graph, graph-theory, graph-visualization, java, oop, parser, parsing, spring-boot, threejs, topology
- Language: Java
- Homepage:
- Size: 438 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# stitch-grapher
Java-based stitch connectivity graph engine for topology-aware crochet pattern parsing and modeling.
## Overview
Stitch-grapher is a Spring Boot application that processes crochet patterns in text format and visualizes them as connectivity graphs. It models crochet stitches as a hierarchical abstraction layer, enabling complex pattern analysis and visualization.
## Features
### Currently Implemented
- Parse text-based crochet patterns into a structured format
- Support common pattern syntax
- Repeats like `(sc, inc)x6`, numeric prefixes like `3sc`
- Validate patterns for correctness
- Support increase (`inc`), decrease (`dec`), chain (`ch`), magic ring (`mr`) operations
- Model stitch relationships as a graph
- How stitches connect to each other
- Visualize patterns:
- 2D layout for flat crochet
- 3D circular layout for amigurumi-style patterns
- Support multiple stitch types SC, HDC, DC, HTR, TR, SLST
- Handle row direction for flat patterns
- Expose a REST API to generate graphs from patterns
### To Be Implemented
- Better visualization of 3d circular patterns and 2d flat patterns
- Turn, fasten off operations
## A Basic Example
- **Input Pattern**:
- `3ch`
- `inc sc inc`
- `2dec sc`
- `FLAT`
- **Output**: Sample graph visualization showing stitch connections and hierarchy
- First row produces 3 stitches. Second row has 2 increase operations using row 1 stitches (1x2 + 1 + 1x2), resulting in 5 stitches. Row 3 has 2 decrease operations using row 2 stitches ((1+1)/2 + (1+1)/2 + 1), resulting in 3 stitches.
- So if you have an increase operation, you should have 2 child nodes in the next step.
- If you have a decrease operation, you should have 2 parent nodes in the previous step.
- If you have a normal stitch, you should have 1 parent node in the previous step and 1 child node in the next step.
## More Complex Example
- **Input Pattern**:
- `mr`
- `6sc`
- `6inc`
- `(sc, inc)x6`
- `(2sc, inc)x6`
- `(3sc, inc)x6`
- `30sc`
- `30sc`
- `30sc`
- `(3sc, dec)x6`
- `(2sc, dec)x6`
- `(sc, dec)x6`
- `6dec`
- `CIRCULAR`
- **Output**: Sample graph visualization showing stitch connections and hierarchy
- Screenshot from front:
- Screenshot from the top:
- Row stitches: 6 → 12 → 18 → 24 → 30 → 30 → 30 → 24 → 18 → 12 → 6
## Prerequisites
- Java 17+
- Maven 3.8+
- Spring Boot 3.x
## Getting Started
1. Clone the repository
2. Build the project: `mvn clean install`
3. Run the application: `mvn spring-boot:run`
4. Open your browser and navigate to `http://localhost:8080`
## API Usage
### Graph Generation Endpoint
**POST** `/api/graph`
Accepts a JSON payload with crochet pattern rows and returns a graph representation.
**Request Example:**
```json
{
"rows": [
"3ch"
],
"mode": "FLAT"
}
```
**Response Example:**
```json
{
"nodes": [
{
"id": "5ebe4049-239a-4bba-b337-6648d3646009",
"label": "CH",
"row": 0,
"position": 0,
"direction": "LEFT_TO_RIGHT"
},
{
"id": "604dbe0d-5dae-485f-bb1d-0c715395c801",
"label": "CH",
"row": 0,
"position": 1,
"direction": "LEFT_TO_RIGHT"
},
{
"id": "3d04c832-a2f0-4a2b-8730-b21134b874b0",
"label": "CH",
"row": 0,
"position": 2,
"direction": "LEFT_TO_RIGHT"
}
],
"edges": [
{
"source": "5ebe4049-239a-4bba-b337-6648d3646009",
"target": "604dbe0d-5dae-485f-bb1d-0c715395c801"
},
{
"source": "604dbe0d-5dae-485f-bb1d-0c715395c801",
"target": "3d04c832-a2f0-4a2b-8730-b21134b874b0"
}
]
}
```
## Technologies
- **Spring Boot** - Web framework
- **Maven** - Build and dependency management
- **Java 17+** - Programming language
## License
MIT