Django based Webapp for PID Control Tuning

A responsive website for PID controllers tuning using modern tuning techniques, fractional calculus and opensource software to run identiication routines for raw process data. This project goal is to allow most of the mobile devices to approach controller parametes even with their default hardware limitations switching the computation load to the cloud, this makes low stats computers able to display good aproximations and simulations anywhere they are needed.

The project includes the features below.

• Raw process data fractional order modeling by IDFOM identification rule (Guevara et al. 2015)
• Tune rule for PI/PID controller 0dol through FOMRoT method (Meneses et al. 2019)
• Close-loop simulations and ploting on Plotly library for Python

Getting Started

Follow the next instructions about how to setting up the project locally for development and testing.

Prerequisites

Install the software below to get the project running properly.

• virtualenv

  # For Archlinux, EndevourOS >
  pacman -S python-virtualenv
  
  # For Ubuntu, Debian, Mint
  apt install python3-virtualenv

• npm

   # For Archlinux, EndevourOS >
   pacman -S npm
  
   # For Ubuntu, Debian, Mint
   apt install npm
  

• pip

   # For Archlinux, EndevourOS >
   pacman -S python-pip
  
   # For Ubuntu, Debian, Mint
   apt install python3-pip
  

Git clone the pidtune library required by the webapp:

git clone https://github.com/jeancahu/pidtune.git
pidtune_dir=$PWD/pidtune

Installation

1. Clone the repository.

   git clone https://github.com/jeancahu/PID_synthesis_tool.git

2. Go to test directory, install the virtualenv and project dependencies.

   cd test/server_demo              # Relative to the cloned repository
   virtualenv venv                  # Install the virtualenv once
   source venv/bin/activate
   
   pip install -r requirements.txt  # Install the Django Framework and its dependencies

3. Install pidtune dependency as developer.

   cd server_demo                   # Once inside the project repository directory go to server demo
   cd venv                          # Go to virtualenv directory
   source bin/activate              # Activate the virtualenv
   cd                               
   cd pidtune                       # Go to your directory of the pidtune repository 
   pip install .                    # Install pidtune library

4. Generate database and migrate it to Django

   cd test\server_demo              # Go to server demo directory
   python3 manage.py migrate        # Generate the database and migrate it

5. Install the styles by Django

   cd PID_synthesis_tool            # Go to the root of the repository
   npn install .                    # Install the styles package from js technology, create node_modules
   npn run dist                     # Compress the package to make it easier to send to the server

Usage

1. Go to test directory, activate the virtualenv and run the developer server

   cd test/server_demo        # Relative to the cloned repository
   source venv/bin/activate
   
   ./manage.py runserver

Open the Local site on your preferred browser.

2. On a second terminal to the base directory, run npm run watch to compile the assets JS and CSS.

   npm run watch

License

Distributed under the GPL-3.0 License. See LICENSE.txt for more information.

Contact

Jean Hidalgo - jeancahu@gmail.com

Jose Mario - jomagona01@gmail.com

Project Repository: https://github.com/jeancahu/PID_synthesis_tool