Skip to content

Latest commit

 

History

History

server

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
data
data
 
 
output
output
 
 
public
public
 
 
Procfile
Procfile
 
 
README.md
README.md
 
 
bias.py
bias.py
 
 
bias_util.py
bias_util.py
 
 
requirements.txt
requirements.txt
 
 
runtime.txt
runtime.txt
 
 
server.py
server.py
 
 

README.md

Lumos Server

This folder contains the Lumos backend code. It computes Wall et al.'s [1] metrics as a quantitative measure of analytic focus and establishes a bi-directional communication channel with the Lumos frontend.

Requirements

  • Python 3.10 - Link
  • pip - Link - package installer for Python
  • venv - Link - Serves files in virtual environment

Setup

Create and Activate Virtual Environment

Windows

  1. py -3.10 -m venv venv - create a python3 virtual environment called venv in the current directory
  2. venv\Scripts\activate.bat - enters the virtual environment
    • FROM THIS POINT ON: only use python command to invoke interpreter, avoid using global command py!!

MacOS/Linux

  1. python3.10 -m venv venv / virtualenv --python=python3.10 venv - create a python3 virtual environment called venv
  2. source venv/bin/activate - enters the virtual environment
    • FROM THIS POINT ON: only use python command to invoke interpreter, avoid using global command python3.10!!

Install Packages

  1. python -m pip install --upgrade pip setuptools wheel
  2. python -m pip install -r requirements.txt - installs required libraries local to this project environment
  3. python -m pip install numpy --no-use-pep517 (for M1 Mac. For others, maybe try without --no-use-pep517)
  4. python -m pip install pandas --no-use-pep517 (for M1 Mac. For others, maybe try without --no-use-pep517)

Run

  1. Execute python server.py
  2. This server is served at http://localhost:3000. The production build of the frontend (built using ng build) is served from the public directory. Check the ../app/README.md for more information. Update this in the app repository at app/src/app/models/config.ts > DeploymentConfig.SERVER_URL

References

[1] - Wall, Emily, et al. "Warning, bias may occur: A proposed approach to detecting cognitive bias in interactive visual analytics." 2017 IEEE Conference on Visual Analytics Science and Technology (VAST). IEEE, 2017.