Mandelbrot Fractal Generator

MEAN stack app for generating Mandelbrot and Julia Sets

Copyright (c) 2018-2023 Dr. Cesare Guardino

MIT License (see LICENSE.txt)

Description

• The MEAN stack used is based on the Angular & NodeJS - The MEAN Stack Guide course on Udemy by Maximilian Schwarzmüller, and has been adapted for this application by Dr. Cesare Guardino.
• The core Mandelbrot/Julia Set generator is a C-based code written by Dr. Cesare Guardino.
• The actual fractal image is generated as a contour plot using Gnuplot. The gnuplot program needs to be on the PATH on the backend server.
• The entire application (including both web front/back-ends and compiled Mandelbrot generator code) were tested on Microsoft Windows 10, Ubuntu Linux 18.04 and even a Raspberry Pi Zero.

Development server

• Run ng serve for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.
• Run npm run start:server to start a dev backend Node.js/Express server. Navigate to http://localhost:3000/
• Run mkdir backend\images to create the directory to store uploaded images if it does not already exist.

Build

• Run npm install to download all the required development and runtime dependencies defined in package.json (creates node_modules directory).
• Run ng build to build the project. The build artifacts will be stored in the dist/ directory. Use the --prod flag for a production build.

Deployment

• Run deploy_patch.sh to patch server and DB settings in some of the source files before deploying.
• Run deploy.sh to actually build a production version and automatically deploy to a Linux server. Navigate to http://<REMOTE_HOST>:3000/.
• Run deploy_monitor.sh to check if the node process is running on the Linux server.

Running unit tests

• Run ng test to execute the unit tests via Karma. These are currently not used.

Running end-to-end tests

• Run ng e2e to execute the end-to-end tests via Protractor. These are currently not used.

Further help

For further details please contact Dr. Cesare Guardino on LinkedIn or GitHub