Skip to content

palms-project/palms

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PALMS

GitHub release (latest by date) GitHub Workflow Status (branch) GitHub Python Versions pre-commit.ci status CodeFactor

Installation • Usage • Citation

PALMS: Precise Acquisition LIBS Movement Software

LIBS: Laser Induced Breakdown Spectroscopy

PALMS is a user-friendly control software for multi-axial LIBS robotic positioning systems.

Such systems optimize LIBS by replacing human hands with robotic equivalents to ensure high standards of data quality, efficiency, replicability, and safety.

The PALMS system is split into two parts: the client and the server. The client runs on the user's Windows PC and the server runs on the Raspberry Pi integrated into the robotic system.

Installation

Client

The client is available as a Windows executable. You can retrieve the latest stable version here, and you can find the latest pre-release here.

On each release, the Windows executable is available as palms.exe (or palms-dev.exe for development releases). Download it and run it directly. Windows SmartScreen may throw up a warning; if it does click More info and then Run anyway.

Server

The PALMS server can be installed with the provided install script.

To use it, you must configure it as shown below.

#### CONFIGURATION ####

- REMOTE_USER="pi"
- REMOTE_HOST="raspi"
+ REMOTE_USER="your user"
+ REMOTE_HOST="your host"

#### END CONFIGURATION ####

To run the script:

git clone https://github.com/palms-project/palms
cd palms
./src/server/install.sh

Usage

For the client to communicate with the server, it must have some kind of network connection where it can access the server by the hostname raspberrypi.local. Additionally, port 35007 must be open on both the client and the server.

Client

Double click the palms.exe file and the application should open.

Server

The server runs as a daemon (it automatically starts on boot and runs continuously), so no action should be necessary after it is installed. If it acts strangely, try viewing the logs:

sudo journalctl -fu palms.service

Otherwise, check its status:

sudo systemctl status palms.service

As a last resort, try restarting it:

sudo systemctl restart palms.service

Citation

View the poster on ResearchGate. If you use or reference PALMS, please cite the following:

@article{https://doi.org/10.13140/rg.2.2.36324.65926,
    doi = {10.13140/RG.2.2.36324.65926},
    url = {https://rgdoi.net/10.13140/RG.2.2.36324.65926},
    author = {Shaked, Gideon and Vallone, Max and Dubard, Robert and Ochatt, Claudia},
    language = {en},
    title = {Precise Acquisition {LIBS} Movement Software: An Easily Usable Control Software for Robotized Optomechanical Systems},
    publisher = {Unpublished},
    year = {2021}
}