Skip to content

Latest commit

 

History

History
209 lines (130 loc) · 14.7 KB

README.md

File metadata and controls

209 lines (130 loc) · 14.7 KB
Raw

badge-OS badge-OS

Support this project and keep always updated about recent software releases, bug fixes and major improvements by following on researchgate or github.

badge-researchGate

badge-followers badge-stars badge-forks

DDRS4PALS

badge-license badge-language badge-license

Copyright (c) 2016-2021 Danny Petschke (danny.petschke@uni-wuerzburg.de) All rights reserved.

DDRS4PALS - A software for the acquisition and simulation of positron lifetime spectra (PALS) using the DRS4 evaluation board

pyRemoteDDRS4PALS: DDRS4PALS can be remotely controlled via pyRemoteDDRS4PALS provided by a TCP/IP and xml based API enabling the integration of the DRS4 evaluation board into any customized measurement environment related to PALS, i.e. synchronizing peripherical instrumentation such as temperature (heating/cooling) stages, cycle-loading machines or a vacuum control unit with the DRS4 evaluation board using DDRS4PALS software. Therefore, DDRS4PALS has integrated a server to communicate with.

preview of the user interface of DDRS4PALS


DDRS4PALS

Quickstart Guide on Windows OS

Option 1: via installer

  • Download the latest installer (installer_DDRS4PALS-v1.18.exe): https://github.com/dpscience/DDRS4PALS/releases
  • Run the installer.
  • Windows 10|11: install the Zadig USB driver: https://zadig.akeo.ie/
  • Plug in the DRS4 evaluation board and run the Zadig program.
  • Select the DRS4 evaluation board from the list of devices and click on "Install Driver".
  • Run the DDRS4PALS executable.

The repository of the DDRS4PALS-installer can be found here.

Option 2: manual installation

Related Publications

Publication in SoftwareX (Jun. 2019)

DDRS4PALS

DDRS4PALS: A software for the acquisition and simulation of lifetime spectra using the DRS4 evaluation board (SoftwareX, Elsevier)

Publication in DIB (Feb. 2019)

DIB

Experimentally obtained and simulated Positron Annihilation Lifetime Spectra (PALS) acquired on pure Tin (4N) using DDRS4PALS software were published in the following Data in Brief (Elsevier) article.

How to cite this Software?

  • When running this software for your research purposes you should at least cite the following publication.

DOI

DDRS4PALS: A software for the acquisition and simulation of lifetime spectra using the DRS4 evaluation board

  • Additionally, you must cite the applied version of this software in your study.

You can cite all released software versions by using the DOI 10.5281/zenodo.1219522. This DOI represents all versions, and will always resolve to the latest one.

DOI

v1.x

DDRS4PALS v1.18 (DLTPulseGenerator v1.4):
DOI

This version 1.18 has integrated the new version 1.4 of DLTPulseGenerator library for simulation purposes. This update enables you to incorporate pulse height spectra (PHS) from real data or generated via Geant4, so that effects on the background contributing to the lifetime spectra with regard to the PHS window settings can be studied more realistically.

For more information, see the attached example files demonstrating the integration of a real BC422-Q plastic scintillator PHS spectrum considered as simulation input. The related section/tag in the simulation input file is: tag 'pulse-height-spectrum-PHS'.

DDRS4PALS v1.17 (DLTPulseGenerator v1.3):
DOI

This version 1.17 can be remotely controlled via pyRemoteDDRS4PALS enabling the integration of the DRS4 evaluation board into any customized measurement environment related to PALS, i.e. synchronizing peripherical instrumentation such as temperature (heating/cooling) stages, cycle-loading machines or a vacuum control unit with the DRS4 evaluation board using DDRS4PALS software.

This version is compatible with pyRemoteDDRS4PALS v1.0

DDRS4PALS v1.16 (DLTPulseGenerator v1.3):
DOI

Please, upgrade to v1.16 since v.1.15 is skipping the pulse-shape filter data section during loading from a settings file.

DDRS4PALS v1.15 (DLTPulseGenerator v1.3):
DOI

Since this release (v1.15), DDRS4PALS has implemented a freely configurable HTTP server enabling access to all measurement related relevant data and settings via browser, i.e. url requests.

DDRS4PALS v1.14 (DLTPulseGenerator v1.3):
DOI

DDRS4PALS v1.13 (DLTPulseGenerator v1.3):
DOI

DDRS4PALS v1.12 (DLTPulseGenerator v1.3):
DOI

DDRS4PALS v1.11 (DLTPulseGenerator v1.3):
DOI

DDRS4PALS v1.10 (DLTPulseGenerator v1.3):
DOI

This release (v1.10) contains the analysis tool DQuickLTFit v4.1, which enables lifetime spectra to be directly opened and analysed from DDRS4PALS software. Moreover, lifetime spectra can be directly exported as (*.dquicklt) file providing an easy and convenient way for spectra analysis.

DDRS4PALS v1.09 (DLTPulseGenerator v1.3):
DOI

DDRS4PALS v1.08 (DLTPulseGenerator v1.3):
DOI

DDRS4PALS v1.07 (DLTPulseGenerator v1.2):
DOI

DDRS4PALS v1.06 (DLTPulseGenerator v1.2):
DOI

DDRS4PALS v1.05 (DLTPulseGenerator v1.2):
DOI

DDRS4PALS v1.04 (DLTPulseGenerator v1.2):
DOI

DDRS4PALS v1.03 (DLTPulseGenerator v1.1):
DOI

DDRS4PALS v1.02 (DLTPulseGenerator v1.1):
DOI

Insights ...

signal-scope: monitor the acquired or simulated detector-output pulses


Detector-Pulse Monitor

energy spectra (PHS): select the energy windows assigning the start & stop quanta


PHS

online tracking of the resulting spectra


Spectrum

timing & voltage/gain calibration without the need of running DRSOsc software


calibration

accessing DDRS4PALS remotely via internet browser


DDRS4PALS-http
DDRS4PALS-http-url

remote control of DDRS4PALS via Python-API (pyRemoteDDRS4PALS)


DDRS4PALS-rc
DDRS4PALS-rc-py

producing high-quality lifetime spectra exploiting a set of freely configurable physical filters:

1D median filter for spike-removal and noise-reduction


Median-Filter

pile-up rejection by area-filtering


Area-Filter

detection of misshaped or artifact-afflicted pulses using shape-sensitive filtering


Shape-Filter

License of DDRS4PALS (GNU General Public License)

Copyright (c) 2016-2021 Danny Petschke (danny.petschke@uni-wuerzburg.de) All rights reserved.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

For more details see GNU General Public License v3

Used Third Party Libraries and Licenses

DDRS4PALS is written in C++ using the Qt-Framework licensed under the GNU General Public License v3

The following 3rd party libraries are used by DDRS4PALS software.

ALGLIB

Tino Kluge

Sergejus Zabinski

Danny Petschke

MPFIT (MINPACK-1)

libusb-1.0

DRS4 evaluation board software and source code package

Deploy DDRS4PALS on Windows OS from Source Files using QtCreator

  • Download the QtCreator and the Qt-framework (at least v5.x).
  • Download and Setup the MS Visual Studio compiler (at least version 2013). It should also work with any other compiler e.g. MinGW but I recommend using VS compiler.
  • Open the .pro file in QtCreator.
  • Deploy DDRS4PALS. It should finish without any errors.
  • Connect your DRS4-EB (if available) and start the simulation or acquisition mode.
  • Finished.