construct is a native JavaScript/ES6 based, digital organisms evolution simulator. It's used for study the evolutionary biology of self-replicating and evolving computer programs (digital organisms). This project similar to Avida, but works with more abstract language (Digital Organism Script - DOS) instead of assembler. It uses special DOSVM for running DOS byte code and distributed computing to speed up the calculations. Generally, it consists of servers, which just a proxies between clients. All calculations are made on a client side only. It's possible to run the system in a "serverless" mode. For this, you have to run index.html (just drop it into the browser) in Chrome without server. More details for russian speaking people on blog and youtube channel. See video presentation here.
- Last version of Chrome browser
- Last stable version of Node.js
- Install Chome browser
- Install Node.js
- Clone this repo to your local machine
- Go to the root folder of cloned repo
- Run
npm installto install all dependencies - Run
npm run buildto build client part - Run tests using
npm run testcommand if you need
- To run construct in a "serverless" mode, just open
./client/dist/index.htmlin Chrome - To run construct in a "distributed" mode, you have to:
- Choose some host in your local netwok for server
- Clone construct repo to this host
- Go to configuration
./client/src/share/Config.js, findserverHostoption and change it to the IP, of your server host. You may useipconfigunder windows to get server's IP - Run
npm run buildcommand in a terminal from the root folder - Run server
npm run serveron chosen host - Copy
./client/dist/index.htmland./client/dist/app.json all your remote machines and run it there under Chrome
As an administrator, you may affect the system by command line API. For instance, you may obtain amount of organisms in current population or set new configuration in real time. For this, you have to open Chrome console (press F12) and type man.api[.namespace].xxx(). Where namespace is an optional unit or module and xxx() is supported command of this module. It's possible to use desc property to get command description. Example: man.api.getConfig.desc. Here are all available commands separated by namespace:
- global namespace -
man.api:man.api.visualize(show:Boolean = true)- Turns on/off visualization in browser for current instance (world). Turning visualization off, increases application speed.man.api.formatCode(code:Array)- Converts byte code array into human readable JavaScript based code. This function is low level. For using it you have to get organism's virtual machine reference and then use it'scodeproperty. For example:man.api.formatCode(man.api.organisms.getOrganism('128').vm.code). This example will find organism with id128and shows his byte code.man.api.version- Returns current app versionman.api.getConfig(path:String)- Returns specified config value. First parameter is a namespace (optional) and config name. For example, to get maximum amount of organisms in current instance/world type:man.api.getConfig('organisms.orgMaxOrgs'). Example of organism related configs you may find here. Other configuration parameters are located in files with nameConfig.js.man.api.setConfig(path:String, value:Any)- Sets configuration value in real time. Opposite togetConfig().
- charts namespace -
man.api.charts. This namespace is related to statistics in charts. There are many parameters like average code size, organisms amount, amount of picked energy and so on. See details here in charts property. You may show and hide different charts on a canvas, locate them and reset any time you need:man.api.charts.on([[name:String = undefined[, show:Boolean = true]])- shows chart(s) by name. List of all available names you may find here. Example:man.api.charts.on('energy')- will show chart of average organism energy at the moment. Calling this method without parameters shows all available charts. Calling this method with only one string parameter shows specified chart. Calling this method with two parameters shows/hides specified chart depending on second Boolean parameter. Example:man.api.charts.on()- shows all charts.man.api.charts.on('energy')- shows energy chart only.man.api.charts.on('energy', false)- hides energy chart only.man.api.charts.off(name:String = undefined)- opposite toon(). Hides specified or all charts (without parameters) from the canvas.man.api.charts.pos(name:String, pos:String)- Locates chart according to specified position. Available positions are:full,top,down,left,right,topleft,downleft,topright,downright. Example:man.api.charts.pos('code', 'full')- showscodetrend chart on full screen. All available chart names are here.man.api.charts.pos9(name:String, x:Number, y:Number)- The same likepos(), but with chart coordinates in 3x3 grid. For example:man.api.charts.pos9('energy', 0, 2)- will positioning energy chart at the locationx:0, y:2.man.api.charts.pos16(name:String, x:Number, y:Number)- The same likepos9(), but for grid 4x4.man.api.charts.transparent(name:String, val:Number)- Sets chart transparency.valshould be between0..1.valparameter is optional. In this case all charts will have same transparency. Note: to improve speed, typeman.api.visualize(false)in Chrome's devtool console during application run
P.S. If you are a ES6 js developer | Canvas 2D developer | Node.js developer | you just a 
- join us!
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent
