Persephone is a software package for storing measurements of material radiopurity. It was originally created by James Loach at LBNL.
Contributors: James Loach, Jodi Cooley, Adam Cox, Zheng Li, Khang Nguyen, Alan Poon, Benjamin Wise.
Supporting institutions and collaborations: AARM (Assay and Acquisition of Radiopure Materials), Karlsruhe Institute of Technology (KIT), Lawrence Berkeley National Laboratory (LBNL), Shanghai Jiao Tong University (SJTU), Southern Methodist University (SMU).
This work was partially supported by the National Science Foundation under Grant Number 1242640.
If you want to help develop this code, contribute your data to the community database, or use the software in your experiment or institution then please contact us.
- "ofhc copper"
- copper AND ofhc
- copper OR lead
Searches are case-insensitive and OR by default.
To view all assays enter 'all'.
This is how to install on a local version of the app:
- Clone Persephone into a directory
- Create a couchdb
[DB]and set the permissions appropriately. Create an admin user with username
- From the
persephonedirectory send the app to the database using the couchapp tool:
couchapp push persephone http://[UN]:[PW]@127.0.0.1:5984/[NAME]
- If successful you will receive a URL to your app.
- Search functionality will only be available if couchdb-lucene is installed and running.
Installation via replication
An alternative way to install the app is to replicate it from an existing installation.
Data can be viewed and input via the user interface but it's also easy (and sometimes more inconvenient) to do these things from the command line. For example, if your raw measurements were in an Excel file, you could: export them to a .csv file, convert this file into JSON documents using a python script and then upload the documents using the python
A set of processing tools are provided in the
tools directory for uploading data (
upload.py), downloading data (
download.py) and cleaning all measurements from an existing database (
When uploading assays it's important to check JSON documents against the data specification (the schema in
_attachments/schema/v3.00.schema.json). A way this can be done is illustrated in
The community-wide installation is available at www.radiopurity.org.