thiagojm / rngkitpsg

This application uses two types of TRNGs - True Random Number Generators (TrueRNG and Bitbbabler) for data collection and statistical analysis for several purposes, including mind-matter interaction research.

RngKit 3.0

by Thiago Jung
https://github.com/Thiagojm/RngKitPSG
[email protected]
Written in Python 3.11.4

Important note

From version 3.0 onwards we adopted a new datetime and file naming format, so analyzes made with previous collected files will not work, for that use the 2.x verions!

ABSTRACT

This application uses two types of TRNGs - True Random Number Generators (TrueRNG and Bitbbabler) and a Pseudo RNG (based on python secrets module) for data collection and statistical analysis for several purposes, including mind-matter interaction research.
It uses random number generation to collect and count the number of times the '1' bit appears in a series of user-defined size and interval. Afterwards, the data can be analyzed and compared with the number expected by chance (50%) and create a chart with a cumulative Z-Score.

Supported Hardware:

1- TrueRNG and TrueRNGPro (https://ubld.it/);
2- Bitbabbler Black and White (http://www.bitbabbler.org/what.html);
3- No Hardware: Pseudo RNG (using Python Secrets Module - it it not truly random).

Installation

1- Hardware Installation: The default installation path is: "C:\Users\Username\RngKit" - Where Username is the name of the windows current user.
1.1- TrueRNG e TrueRNGPro:
Choose from the 2-Installation folder (inside the "C:\Users\Username\RngKit") the TrueRng folder, the folder for your device (TrueRng3 or TrueRngPro) Within this folder, right-click the TrueRNG.inf or TrueRNGpro.inf file and select Install. Follow the instructions for installation.
1.2- Bitbabbler:
Inside the 2-Installation\BitBabbler folder (inside the "C:\Users\Username\RngKit"), run vcredist_x64.exe (source: http://www.microsoft.com/en-us/download/details.aspx?id=30679) and follow the installation guidelines. Insert your bitbabbler device into a USB port and run the zadig-2.8.exe file (source: http://zadig.akeo.ie/). Select your device and click "Install Driver". Wait for the process to finish and close the program.

Usage

1- Start the program;
2- The program has 3 tabs:

• TAB 1: The first tab is for analysis and collecting data:

Collecting:

To collect data, select the device to use, or multiple devices and click "Start". You can set the sample size (in bits) and the sample interval (in seconds). BitBabbler has different capturing options (number of folds), with option 0 being in RAW, options between 1 and 4 in XOR, TrueRNG only works in XOR mode. PseudoRNG uses the python secrets module that gathers entropy from your system, it´s not a good source of true randomness, but you can use if you don´t have a hardware RNG. Hit "Stop" when you wish to stop the process. Two files are going to be created inside the "1-SavedFiles" folder. One with .bin extension and another with .csv. The .bin is in binary form and is used as a controller. The .csv contains more info, like the time of each collected series and the count of 'ones' that appeared in each series. Usually will be better to analyse the .csv file.

Analysing:

To analyse the file and generate a Excel file with z-score and a graph, select a previously generated .bin or .csv file whit the "Browse" button. It will detect the interval and the sample size from the filename, so dont change it. Clicking "Generate" will automatically generate a file with the same name as the one selected, but with extension .xlsx, with the analyzed data. This data and chart represent the cumulative z-score of 'ones' that appeared in the samples. This file will be saved in the "1-SavedFiles" folder. You can click "Open Output Folder" to open Windows Explorer at the file location.

Concatenate:

If you want to concatenate CSV files, browse the files in the "Concatenate Multiples CSV Files". It will create a new concatenated file. Its important to concatenate only files with the same interval and sample size, or you will get wrong results. Select the proper Sample Size and Interval before concatenating from the inputs above.

• TAB 2: The second tab is for collecting and presenting a live Zscore x Time chart.

Select the device to use (BitBabbler can be set to 0 (RAW) or 1 (XOR)). Click on "Start", the chart will update and at the same time two files will be generated and saved (.bin and .csv). When you finish capturing it is important to click "Stop".

• TAB 3: Instructions Tab

3- File naming convention:
The file name contains important information about the collected data. The first part is the date and time of the collection, then the device used (trng for TrueRN, bitb for Bitbabbler and pseudo for PseudoRNG), the number of bits per sample, the time between each sample in seconds and finally, only on Bitbabbler devices, whether in RAW or in XOR (number of folds). For example "20201011T142208_bitb_s2048_i1_f0": Collected on October 11, 2020 (20201011), at 14:22:08 (142208), Bitbbabler device (bitb), sample of 2048 bits (s2048) every 1 second (i1), RAW mode (f0).

License

MIT License

Copyright (c) 2023 Thiago Jung Mendaçolli

ScreenShots

rngkitpsg's Issues

Screenshots?

Hi there.... it seems like you've got a GUI in your project, but I can't tell for sure. It would be great to see some screenshots in your readme if you've got a moment to add them. They definitely grab the attention of visitors as it's not all that common for Python programs to have a GUI and when they do, people like seeing pictures.