Patterning-Core

KO | EN

gitlite — search

#javascript #python #hacktoberfest #typescript #llm #machine-learning #deep-learning #linux #nodejs #macos #java #awesome #kubernetes #openai

Patterning-Core

(★ 10)

New core for the Patterning library. Creates only the data-structure and SVG. No Quil / Processing dependency.

Patterning-Core Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Patterning

A Clojure library for generating patterns, both at the small scale and the "layout" of smaller units. Units can be recursively nested. It was originally written to work with [Quil](https://github.com/quil/quil), the Clojure wrapper around [Processing](https://processing.org/), but has now been broken into several separate projects.

### Patterning Core

This repository, Patterning Core, contains code to generate patterns. But is no longer referencing or dependent on Quil / Processing at all. The generated patterns are merely data-structures. This library contains a function to render them as simple SVG. But it's likely you will want to write your own renderer for the pattern in the framework / environment you are working in.

Patterning Core is now in cljc, so it can be compiled to both Clojure and ClojureScript. And it can run in the browser.

A compiled version of this library is now available on Clojars. Include in your Lein project using :

[![Clojars Project](http://clojars.org/com.alchemyislands/patterning/latest-version.svg)](http://clojars.org/com.alchemyislands/patterning)

(See below for an example of how to do this.)

## How (and Where) to Use It

### Patterning works in ClojureScript

The easiest way, today, to just play around with Patterning is to try it in the [online tutorial](https://alchemyislands.com/assets/patterning-tutorial/HelloWorld.html). Any Pattern from the tutorial can be opened in our browser-based *workbench" (previously known as Project RoseEngine).

Go to the Workbench directly : [https://alchemyislands.com/assets/patterning-tutorial/workbench/index.html](https://alchemyislands.com/assets/patterning-tutorial/workbench/index.html)

This is a ClojureScript, in-browser environment which uses the Small Clojure Interpreter to interpret and render patterns. From this workbench you can load and save patterning code, and export patterns as SVG or PNG.

### Patterning in Cardigan Bay

[Cardigan Bay](https://github.com/interstar/cardigan-bay), a wiki / note-taking / digital gardening engine written in Clojure, also has Patterning built in. That means you can add patterns to your wiki in the form of short embedded scripts.

Cardigan Bay is another easy way to play with Patterning without writing your own application. It's distributed as a Java app that will run on any desktop OS. You don't need a Clojure environment installed.

### Other Documentation

As of writing, https://github.com/nataliefreed also has some nice documentation of the different functions in Patterning at : https://docs.google.com/document/d/1kKsBw3C4jrPGtr7BRYbmcbid4FgWn0_CzdNy1bQ60b8/edit?pli=1

### Patterning Quil

[A separate project](https://github.com/interstar/Patterning-Quil) now shows how to use Patterning Core in a Quil / Processing project. See the example on that page.

### Patterning for Processing

Patterning was originally written to be used in all-Clojure projects. But for those who are already more familiar with, or need to work in, Java and the Processing development environment itself, there's now a standard Processing Library wrapper around Patterning.

The source for that library and examples are on [Patterning for Processing](https://github.com/interstar/Patterning-for-Processing). They are based on the standard Processing Library template.

### Patterning in FX(hash)

Patterning supports creating generative NFTs for the FX(hash) NFT market. The distinctive feature of FX(hash) is that it enables (and requires) works that contain randomness, to use its own deterministic pseudorandom library which seeds the random number generator with an ID based on the NFT token. The practical upshot is that each minted edition of the NFT will look different (due to being based on a different sequence of random numbers), but every time you look at the same minted edition of the work it will look (or evolve) the same way.

This gives each minted edition a unique identity.

To support this usage, all Patterning functions that use random numbers now take an optional argument of a "RandomGenerator". RandomGenerator is a Clojure Protocol defined maths.cljc that declares a number of methods for returning random integers, floats, angles and items from collections.

In the directory NFTmaker/ in this repository, there is an example of a simple system for making Patterning based NFTs. This includes fxhash_random_generator.js, a Javascript implementation of an object that corresponds to the RandomGenerator protocol, but uses the FX(hash) library.

There's more information in the README in that directory.

## What Patterning looks like

<img src="https://alchemyislands.com/media/lsys.png" width="40%"/>
 
See more examples in the [Patterning Tutorial](https://alchemyislands.com/assets/patterning-tutorial/HelloWorld.html)

## Quick Start

git clone https://github.com/interstar/Patterning-Core.git Patterning
    cd Patterning
    mkdir outs
    lein run
    
You should see that Patterning has produced several example patterns in the outs directory.
    
Check [src/clj/patterning/demo.clj] for the demo runner that made these patterns.

# DEPRECATED

[Older Patterning repo](https://github.com/interstar/patterning).

## License

Distributed under the [Gnu Lesser General Public License](https://www.gnu.org/licenses/lgpl.html) 
either version 3.0 or (at your option) any later version.

Patterning-Core

Patterning-Core Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Patterning-Core

Patterning-Core Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README