A program for controlling a miniturized additive friction stir deposition (AFSD) machine.
Project description
mini_afsd is a program for controlling a miniturized additive friction stir deposition (AFSD) machine.
For Python 3.7+
Source Code: https://github.com/RyTheGuy355/MiniAFSDCode
Introduction
This repository contains code for controlling a miniturized AFSD machine and is used by the Yu group at Virginia Tech.
Communication with the machine is achieved using FluidNC, and future modifications to the firmware or code inputs can be helped by looking through FluidNC’s documentation.
Installation
Dependencies
Driver Dependencies
The LJM driver from LabJack must be installed to interface with the LabJack for measuring the thermocouple outputs, which can be downloaded from https://labjack.com/support/software/installers/ljm.
The driver needed for computers to properly connect to the serial port’s USB interface is available from https://oemdrivers.com/usb-cp2104-usb-to-uart-driver. (Change this in the future if the connector changes)
Python Dependencies
mini_afsd requires Python version 3.7 or later and the following Python libraries:
matplotlib (>=3.4)
All of the required Python libraries should be automatically installed when installing mini_afsd using any of the installation methods below.
Installing Python
Python can be installed multiple ways:
If on Windows, the easiest way is to use WinPython. The recommended installation file (as of June 10, 2022) is WinPython64-3.10.4.0 (or WinPython64-3.10.4.0dot if you don’t want any preinstalled libraries).
Use Anaconda, which comes with many libraries preinstalled.
Install from Python’s official source, https://www.python.org/. Follow the instructions listed at https://packaging.python.org/en/latest/tutorials/installing-packages/#requirements-for-installing-packages to ensure Python and the Python package manager pip are correctly installed.
Stable Release
mini_afsd can be installed from pypi using pip, by running the following command in the terminal:
pip install -U mini_afsdDevelopment Version
The sources for mini_afsd can be downloaded from the GitHub repo. To install the current version of mini_afsd from GitHub, run:
pip install https://github.com/RyTheGuy355/MiniAFSDCode/zipball/mainOptional Dependencies
While not needed, an Arduino IDE (available from https://www.arduino.cc/en/software) can be used when connected to the serial port of the mill to get more detailed feedback on the messages sent to and from the port.
Quick Start
For default usage, mini_afsd can be ran from the a terminal (the command line if Python was install universally, from an Anaconda terminal if Python was installed with Anaconda, or from the WinPython Command Prompt if Python was installed using WinPython) using:
python -m mini_afsdTo list out the various options when using mini_afsd from the terminal, simply do:
python -m mini_afsd -hAlternatively, mini_afsd can be used from a Python file by doing the following:
from mini_afsd import Controller
Controller().run()Contributing
Contributions are welcomed and greatly appreciated. For information on submitting bug reports, pull requests, or general feedback, please refer to the contributing guide.
License
mini_afsd is all rights reserved. For more information, refer to the license.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for mini_afsd-1.2.1-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 213b59db8f11ef05856cc6405f37f2115a9d7d64b4f874f805d3622ab0d0dd2e |
|
| MD5 | a061126a6d910add5f1e90dfb3cbb0bf |
|
| BLAKE2b-256 | c4c32b032f13dfb6df6b69c14c07d12530a86215abcafc070c3a2969b7a77696 |
