pi-emergence
v1.0.36
Published
Various emergent phenomena
Downloads
21
Maintainers
Readme
JavaScript Emergence Engine
A collection of libraries demonstrating emergence of some sort. I tried to stay away from major frameworks, but that isn't always very reasonable.
Running
Best way is to use http-server
... But you can simply double click any of the index.html files individually. Just know that navigation may be a bit funky.
3rd Party Libraries
- JQuery - Mainly for UI/UX outside the canvas UX (React was more trouble than it was worth)
- p5.js - For drawing/rendering and Vector math
- axios - Not really used as of now, but will be used to save/load snapshots (among other cool stuff that you should be real excited about)
- http-server - Not included, and optional. Used to run the project. To install,
cd
into the root directory and run it. Installation steps below:
Install http-server Utility
http-server
is a convenient utility that spins up a server instance on your local box
Check the http-server npm page for more info.
> npm install -g http-server
Run http-server Utility
cd
into the root of this project and run it. Steps are:
> cd pi-particles
> http-server
Architecture
Each of the modules will (eventually) have the same general arhitecture and pattern.
It consists of three swappable abstraction layers (not to be confused with Neural Network Layers - So we will also refer to the abstraction layers as "segments
" in this repo), plus the "non-swappable"
Presentation Layer, which is a web page/DOM
Data Layer
Business Logic
This is where most, if not all, of the guts are. Inside the
/lib
directory, there are subfolders respectively named after each module, plus a/lib/common
directory that holds all the reusable component JavaScript files. Each of the modules get more specialized/specific, the deeper you go into the project's folder structure
Rendering Layer
Basically, the layer that draws onto the canvas or other medium. Canvas is the most common, but others like CSS/DOM,
Presentation Layer
Normal web page/DOM. JQuery is used here, but you can use React, Veu, etc.
Modules
Currently, there are three base modules: Neural Networks, Particles, and Tentacles.
Toast.
Neural Network (/lib/neuro)
The furthest along. Currently a Feed Forward network using matrix math, and a NeuroApp visualizer which uses p5 for both vector math and drawing to the canvas. You can swap out the math module and the drawing module. See the readme file. Neuro Readme.md.
Particle Life
This "works" but probably consider this "as is." The UI/UX is funky, and I'm not 100% on the close-quarters repulsive force function Particles Readme.md.
Tentacle Physics (/lib/tentacles)
I need to put some time into this one still. The demo is good for a tentacle following the mouse, but I need to implement pendulum/gravity physics and state changing, as this will eventually be a game element (NPC or otherwise) Tentacles Readme.md.