Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/laurarozier/pyradmon-reborn

PyRadmon, a Python radiation monitoring util to use on both Linux and Windows.
https://github.com/laurarozier/pyradmon-reborn

Last synced: 26 days ago
JSON representation

PyRadmon, a Python radiation monitoring util to use on both Linux and Windows.

Host: GitHub
URL: https://github.com/laurarozier/pyradmon-reborn
Owner: LauraRozier
Created: 2016-05-30T19:26:14.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2019-01-25T21:13:06.000Z (almost 6 years ago)
Last Synced: 2024-04-16T07:48:53.745Z (8 months ago)
Language: Python
Size: 77.1 KB
Stars: 1
Watchers: 2
Forks: 1
Open Issues: 1
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# PyRadmon-Reborn
[![Python Versions](https://img.shields.io/badge/Python-2.7-brightgreen.svg)](https://github.com/thibmo/PyRadmon-Reborn) [![Build Status](https://travis-ci.org/thibmo/PyRadmon-Reborn.svg?branch=master)](https://travis-ci.org/thibmo/PyRadmon-Reborn)
[//]: # (Title and short description)
PyRadmon, a Python radiation monitoring util to use on both Linux and Windows.

### Installation
[//]: # (Installation requirements with links)
The first thing you should know is whether you would like to use one, or two counters.
In the case of a single counter you should download PyRadmon, in the case of two counters use MultiPyRadmon
**Always use the right file for the right amount of counters!**

#### Windows
To use PyRadmon Reborn on your Windows machine you would first have to follow the following steps.
- Install Python
- Download [Python 2.7.x for Windows](https://www.python.org/downloads/windows).
- Install Python 2.7.x with it's default settings, making sure to read well,
the installer must create the edit to the system variables.
- Install PIP (If it is not yet installed)
- Test if PIP is installed.
```
python -m pip list
```
- If Python gave an error, you should [install PIP](http://pip.readthedocs.io/en/stable/installing).
- Install PySerial
- Install PySerial for Python 2.7 with it's default settings.
```
python -m pip install pyserial
```
- Install PyAudio
- Install PyAudio for Python 2.7 with it's default settings.
```
python -m pip install pyaudio
```
- Download (Multi)PyRadmon.py
- [Download](https://github.com/thibmo/PyRadmon-Reborn/releases) the preferred version.
- Put the file to the preferred location.

#### \*bian/\*buntu
To use PyRadmon Reborn on your Linux machine you would first have to follow the following steps.
- Install using these commands for python, PySerial and PyAudio.
(If in GUI mode, first open the Terminal, **NOT THE ROOT TERMINAL**.)
- cd ~
- sudo apt-get install python-dev
- sudo apt-get install python-serial
- su
- [Type your password, if required.]
- adduser dialout
- reboot
- [Log back in to the user you used before.]
- cd ~
- Check your system architecture
```
uname -p
```
- If your architecture is x86_64 then install both amd64 and i386 packages.
For x86_64 you will need one extra step before installing the i386 package :
```
sudo apt-get install libc6:i386 -y
```
- Download the .deb file that fits your system from either the official repository : [Debian Portaudio Repo](http://ftp.de.debian.org/debian/pool/main/p/portaudio)
Or my mirror : [KP-Wiki Portaudio Repo](https://kp-wiki.org/freeware/portaudio)
- For ARM ( R-Pi 2 B+ ) this is ( Using Debian{/Ubuntu} repo ) :
```
wget http://ftp.de.debian.org/debian/pool/main/p/portaudio/libportaudio0_18.1-7.1_armhf.deb
```
- For 32-bit this is ( Using Debian{/Ubuntu} repo ) :
```
wget http://ftp.de.debian.org/debian/pool/main/p/portaudio/libportaudio0_18.1-7.1_i386.deb
```
- For 64-bit this is ( Using my repo ) :
```
wget https://kp-wiki.org/freeware/portaudio/libportaudio0_18.1-7.1_amd64.deb
```
- Install the package
```
dpkg -i libportaudio0_18.1-7.1_[armhf, i386, amd64 - depending on the package you need to install].deb
```
- sudo apt-get install libportaudio2 libportaudiocpp0 portaudio19-dev
- sudo apt-get install git
- sudo git clone [http://people.csail.mit.edu/hubert/git/pyaudio.git](http://people.csail.mit.edu/hubert/git/pyaudio.git)
- cd pyaudio
- sudo python setup.py install
- Download (Multi)PyRadmon.py
- [Download](https://github.com/thibmo/PyRadmon-Reborn/releases) the preferred version.
- For MultiPyRadmon
```
wget 'https://github.com/thibmo/PyRadmon-Reborn/releases/download/v1.2.0/MultiPyRadmon[.-.No.Audio].zip'
```
- For PyRadmon
```
wget 'https://github.com/thibmo/PyRadmon-Reborn/releases/download/v1.2.0/PyRadmon[.-.No.Audio].zip'
```
- Unpack the tarball to the preferred location.
```
tar zxvf (Multi)PyRadmon.tar.gz -C ~/PyRadmon
```

### Running PyRadmon Reborn for the first time
[//]: # (First run information)
#### Windows
- Run (Multi)PyRadmon.py once.
- Open command prompt
- Click on Start
- Type "cmd" in the search bar.
- Right click CMD.exe and left click "Run as Administrator"
- If you are asked for a confirmation, select "Yes" or "Ok"
- Change the directory to where you have downloaded (Multi)PyRadmon.py
Eg: cd C:\Users\\Downloads
- Run (Multi)PyRadmon.py once to create the config file.
- ```python ./(Multi)PyRadmon.py``` *
- Close the command prompt.
- Edit the config.txt file, this will be created in the same directory where you stored your (Multi)PyRadmon.py
- Run (Multi)PyRadmon again, it will now start monitoring/uploading to Radmon.org using the configured settings.
- Open command prompt
- Click on Start
- Type "cmd" in the search bar.
- Right click CMD.exe and left click "Run as Administrator"
- If you are asked for a confirmation, select "Yes" or "Ok"
- Change the directory to where you have downloaded (Multi)PyRadmon.py
Eg: cd C:\Users\\Downloads
- Run (Multi)PyRadmon.py.
- ```python ./(Multi)PyRadmon.py``` *

\* = Might this give you an error, follow these steps: Python help on Windows

#### \*bian/\*buntu
- Run (Multi)PyRadmon.py once.
- In the command line type:
- ```cd ../Location/To/The/File```
- ```python ./(Multi)PyRadmon.py```
- In the GUI:
- Open the Terminal and type:
- ```cd ../Location/To/The/File```
- ```python ./(Multi)PyRadmon.py```
- Edit the config.txt file, this will be created in the same directory where you stored your (Multi)PyRadmon.py
- ```nano config.txt```
- In nano you can exit with saving by pressing [Ctrl] and [X] simultaneously, then pressing [Y] to confirm.
- Run (Multi)PyRadmon again, it will now start monitoring/uploading to Radmon.org using the configured settings.
- ```python ./(Multi)PyRadmon.py```

### Updating PyRadmon Reborn
[//]: # (Updating information)
#### Windows
- Stop the program
- Press [Ctrl] and [C] simultaneously.
- Close the command prompt
- Delete the old files and folder
- Download (Multi)PyRadmon.py (Multi)PyRadmon.zip
- Download the preferred version in .zip format.
- Unpack the file to the preferred location.
- Run (Multi)PyRadmon.py once.
- Open command prompt
- Click on Start
- Type "cmd" in the search bar.
- Right click CMD.exe and left click "Run as Administrator"
- If you are asked for a confirmation, select "Yes" or "Ok"
- Change the directory to where you have downloaded (Multi)PyRadmon.py
Eg: cd C:\Users\\Downloads
- Run (Multi)PyRadmon.py once to create the config file.
- ```python ./(Multi)PyRadmon.py``` *
- Close the command prompt.
- Edit the config.txt file, this will be created in the same directory where you stored your (Multi)PyRadmon.py
- Run (Multi)PyRadmon again, it will now start monitoring/uploading to Radmon.org using the configured settings.
- Open command prompt
- Click on Start
- Type "cmd" in the search bar.
- Right click CMD.exe and left click "Run as Administrator"
- If you are asked for a confirmation, select "Yes" or "Ok"
- Change the directory to where you have downloaded (Multi)PyRadmon.py
Eg: cd C:\Users\\Downloads
- Run (Multi)PyRadmon.py.
- ```python ./(Multi)PyRadmon.py``` *

\* = Might this give you an error, follow these steps: Python help on Windows

#### \*bian/\*buntu
- Stop the program
- Press [Ctrl] and [C] simultaneously.
- Delete the old files and folder
- ```cd ~```
- ```rm -rf PyRadmon```
- Download (Multi)PyRadmon.py (If in GUI mode, first open the Terminal, NOT THE ROOT TERMINAL.)
- Download the preferred version in .tar.gz format.
- For MultiPyRadmon
- ```wget 'https://github.com/thibmo/PyRadmon-Reborn/releases/download/v1.2.0/MultiPyRadmon[.-.No.Audio].zip'```
- For PyRadmon
- ```wget 'https://github.com/thibmo/PyRadmon-Reborn/releases/download/v1.2.0/PyRadmon[.-.No.Audio].zip'```
- Unpack the tarball to the preferred location.
- ```tar zxvf (Multi)PyRadmon.tar.gz -C ~/PyRadmon```
- Run (Multi)PyRadmon.py once.
- ```cd ~/PyRadmon```
- ```python ./(Multi)PyRadmon.py```
- Edit the config.txt file, this will be created in the same directory where you stored your (Multi)PyRadmon.py
- ```nano config.txt```
- In nano you can exit with saving by pressing [Ctrl] and [X] simultaneously, then pressing [Y] to confirm.
- Run (Multi)PyRadmon again, it will now start monitoring/uploading to Radmon.org using the configured settings.
- ```python ./(Multi)PyRadmon.py```

### What script to use?
[//]: # (Some explainatory text about the different scripts)
It all depends on what your end-goal is.
Below this text you will find a small guide to finding the script you will need.
- If you are not sure, or you have an audio counter, and you only have one device, then use "PyRadmon".
- If you don't need audio support and you only have one device, then use "PyRadmon - No Audio".
- If you are not sure, or you have an audio counter, and you have two devices, then use "MultiPyRadmon".
- If you don't need audio support and you have two devices, then use "MultiPyRadmon - No Audio".

[//]: # (Features and misc)
### Features
- This project is open for requests
- Audio meter support through "taps"
- UART-TTL USB module support
- DIY-kit support, for new kits I am willing to add special methods to process their data
- Reports CPM data from a Geiger counter to RadMon.org or any that support the format
- Supports MyGeiger counters (serial)
- Supports NetIO counters (serial)
- Supports GQElectronics GMC counters (serial)
- Supports two equal or different Geiger counters at the same time through multi-threading