Skip to main content

Python wrapper to interface with LocalDB and Production DB for common tasks for pixel modules.

Project description

Module QC Database Tools v0.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, required=True: Path to output directory config folder will be placed in

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

module_qc_database_tools-0.1.0.tar.gz (15.5 kB view details)

Uploaded Source

Built Distribution

module_qc_database_tools-0.1.0-py3-none-any.whl (14.1 kB view details)

Uploaded Python 3

File details

Details for the file module_qc_database_tools-0.1.0.tar.gz.

File metadata

File hashes

Hashes for module_qc_database_tools-0.1.0.tar.gz
Algorithm Hash digest
SHA256 4b2209a3706922f764e284168965cc609804be076b8cfa6799b2b4c59289bbe3
MD5 d204f1486f32d697838ae6b267a43c20
BLAKE2b-256 5a5f66c8d670e1956e2ae3e80709f66337b4a87bbe3c0d3993329604660dfe10

See more details on using hashes here.

File details

Details for the file module_qc_database_tools-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for module_qc_database_tools-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 dbe12688fa098d8343c64f0287a8b9b25fa5bc1043e8939930b9945bed8c56c9
MD5 24c76f8cdd7371c8bec1ebdec0a5fd78
BLAKE2b-256 b2b2b44aca19b006460feff1a4481feb224262c33b5d8fc75260c780c763fa1f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page