Uses data gathered from an iPad and the Structure Sensor by Occipital to classify things into their respective shapes. Python is required to be able to run this program.
- Features
- Known Application Bugs
- Installation
- Run the PyScan virtual environment
- Running the PyScan Application
- Troubleshooting
Mail Parser - Log in to your email to select and download scans
Object Classifier - Load a .obj or .ply file to classify its shape
- If show model window is open, the main GUI window will not update until the show model window is closed
- When the classify button is repeatedly pressed multiple times, the application will stall.
- When classifying is processing and user clicks any button before processing is complete will cause the program to not function properly
Refer to the Python 3 Installation & Setup Guide to properly configure and install Python.
For our program, we used Python 3.6.
Download Git from here. You will need this to clone the GitHub repository.
In a terminal window, cd to a location you want to save the repository to. Run one of the following commands:
git clone https://github.com/MakePlusGroup/MakePlusProject.git
A virtual environment is provided if the dependencies are not installed. However, all dependencies can be installed using this command in the root folder of the repository:
pip install -r requirements.txt
pip3 install -r requirements.txt
A virtual environment is provided if the dependencies are not installed, allowing you to use all of the libraries needed without having to install it on your computer. Keep the environment active when running the application.
Run the following line in Command Prompt:
PyScan\Scripts\activate
The terminal should now look something like this:
(PyScan) D:\pyscan>
Proceed to: Running the PyScan3D Application.
Run the following line in the terminal:
source /PyScan/bin/activate
The terminal should now look something like this:
(PyScan) root@localhost:~/pyscan$
Proceed to: Running the PyScan Application.
To terminate the application, you will need to deactivate the virtual environment.
To deactivate, type:
PyScan\Scripts\deactivate
or on Linux/MacOS:
deactivate
In the root folder of the repository type:
python pyscan.py
This allows you to load in a single .obj or .ply file to compare it to the data saved in the object_data.csv file.
Refer to Known Application Bugs if the problem is not listed here.
Ensure you are in the root folder. This is the main folder that houses all the files. If you cloned from GitHub, the root/main folder is called pyscan.
Install a dependency using this command:
pip install <dependency name>
pip3 install <dependency name>
Alternatively, all dependencies can be reinstalled: Installing Dependencies