Skip to content

HPI-ELEA/elea

Repository files navigation

elea

Netlify Status github actions

This is a little tool designed to prototype evolutionary algorithms, get an intuition for runtimes or for teaching EAs to students.

People

The project is organized by the following two scientists.

  • Markus Wagner (Monash University)
  • Timo Kötzing (Hasso Plattner Institute)

Contributors to the code base of ELEA have been the following people.

  • Bjarne Sievers (Winter Term 2020/21, as part of a project seminar at HPI)
  • Antony Kamp (as a HiWi at HPI, 1.1.2021 -- 31.3.2022)
  • Erik Kohlros (as a HiWi at HPI, 1.10.2021 -- 31.3.2024)
  • Oscar John Ammirato Manglaras (Jul-Nov 2021 as one-semester, 3rd year project at the University of Adelaide) [email protected] https://github.com/CogentRedTester
  • Gerome Quantmeyer (as a HiWi at HPI, 1.7.2022 -- 31.3.2023)
  • Omri Bornstein (Feb-Nov 2023 as a two-semester, 3rd year project at Monash University) [email protected], https://github.com/applegamer22

Run

  • install nodeJS with npm
  • run npm i to install the dependencies
  • run npm run start to run the application

You can find the application at localhost:1234 propably.

More commands for developer

  • run npm run lint to show current linting errors and warnings
  • run npm run prettier to fix formatting errors

Write new blocks

Steps:

  1. Think of all the connections you need and build your block in the block factory:
  2. Copy the json definition into the static/blockDefinition/normalBlocks.js or similar JS file and include it. Add a tooltip to the block and comments to the input to help our users understand your block. If you want to do type-checking, make sure to add the type of your input and output as described in the blockly documentation. Use the Array-type to request a population and Individual to request an individual from the population.
  3. Also copy the JS code stub from the factory into this JS file.
  4. Add the block to the toolbox in any category via its name (roughly in lines 200-450 in workspace.html). You should now be able to see it in the toolbox and use it.
  5. In order to actually do something, you need to replace the generated code with actual code. I essence, you need to return valid JS code in a string (ES5). Since debugging parsing errors is rather hard in this environment I suggest to try atomic expressions you want to use in this live demo. Anything that does not work there will not work in blockly either. Goodbye arrow-functions and other syntactic sugar of ES6!
  6. You should now have a working block 🎉

Additional things to consider: Variables and functions could collide with user defined objects. Blockly can handle this for you, if you let it. You need to ask for valid names etc. In its current state, the documentation is barely understandable and does not prominently mention all necessary functions, I find the predefined open source blocks much more helpful: https://github.com/google/blockly/blob/master/generators/javascript/math.js

blockly