Python wrapper to interface with LocalDB and Production DB for common tasks for pixel modules.
Project description
Module QC Database Tools v2.1.0
The package to regisiter ITkPixV1.1 modules, and generate YARR configs from ITk
production database using itkdb API.
Set-Up and First-time Installation
A minimum of python version 3.7+ is required.
Virtual Python Environment
Creating the python virtual environment the standard way used the python version available on the operating system. For CentOS 7 this is version 3.6. If using CentOS 7, you can install python 3.8 following these instructions.
After installing python 3.8, create the virtual environment:
$ python3 -m venv venv
$ source venv/bin/activate
For future use:
$ source venv/bin/activate
Alternatively, anaconda or miniconda can also be installed.
For future use:
$ conda activate
Install
$ python -m pip install module-qc-database-tools
Environment Variables
If not already set elsewhere (e.g. ~/.bashrc), copy .env.template to .env
and update the values of the shell variables. Essentially, the following
variables regarding the production database should be available, shown below as
an example of environmental variables in ~/.bashrc:
export INSTITUTION="LBNL_PIXEL_MODULES"
export ITKDB_ACCESS_CODE1="accesscode1"
export ITKDB_ACCESS_CODE2="accesscode2"
Module registration
Under construction...
Generate YARR configuration
This script has been tested on python 3.7+.
To generate YARR configuration for a given module, run generateYARRConfig or
mqdbt generate-yarr-config:
$ generateYARRConfig -sn [ATLAS SN] -o [outdir]
$ mqdbt generate-yarr-config -sn [ATLAS SN] -o [outdir]
Parameters:
-sn, --sn, required=True: ATLAS serial number of the module
-ch, --chipTemplate, default="configs/YARR/chip_template.json": provide the path of a chip config template to generate the new chip configs from
-o, --outdir, path to output directory config folder will be placed in. If not supplied, the config files will be pushed into mongoDB if connection is set up.
-f, --fast, fast generation of configs files without any linebreaks.
For example, to generate the YARR configs for the module 20UPGR91301046 with
all power configs:
$ generateYARRConfig -sn 20UPGR91301046 -o ~/module_data/.
$ mqdbt generate-yarr-config -sn 20UPGR91301046 -o ~/module_data/.
The time needed to generate warm and cold L2 configs for a quad module is about 4 seconds.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file module_qc_database_tools-2.1.0.tar.gz.
File metadata
- Download URL: module_qc_database_tools-2.1.0.tar.gz
- Upload date:
- Size: 18.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 5453c184ecf5d7da424a0d54d56409775a679d898cb1ab6c7d4f8043717b6ea5 |
|
| MD5 | d2a4fccd3f7e291f7d2f7e906b38e0be |
|
| BLAKE2b-256 | e1eefa6104266d6f40512cad232730be55c2da53eef3e48f5c69ec2b7e64527f |
File details
Details for the file module_qc_database_tools-2.1.0-py3-none-any.whl.
File metadata
- Download URL: module_qc_database_tools-2.1.0-py3-none-any.whl
- Upload date:
- Size: 16.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0864844ae945c2e7130352258f3fe23ca29b1047a9aeddf8efe45277de035a5e |
|
| MD5 | 5e344d893f0d481d02d071f11e4c86a0 |
|
| BLAKE2b-256 | 8f35c02ee19452c2c7391c3ed10e7cfcaf2e024a9e5712c7346871ae66d7c50b |
