AdvancedAnalysisFileParser
A Python package to parse Illumina-DRAGEN "special caller" outputs (TSV/JSON) into a unified JSON format, with automatic warnings based on user-defined or default conditions. Supports oncology, GBA, SMN, HBA, and more.
Features
- Unified JSON output for multiple DRAGEN caller types (TSV/JSON)
- Automatic warnings for each file type, based on config or defaults
- Pluggable parser architecture for new file types
- CLI and Python API usage
- Example configs and test data included
Installation
Install from PyPI (recommended):
pip install AdvancedAnalysisFileParser
Or from source:
git clone https://github.com/geneyx/geneyx.analysis.api.git
cd geneyx.analysis.api/scripts/AdvancedAnalysisFileParser
pip install -e .
Quickstart
Python API Usage
from AdvancedAnalysisFileParser.AdvancedAnalysisParser import AdvancedAnalysisParser
request = {
"input_dir": "./Test",
"output_dir": "./Test",
"output_json": "adv_output.json",
# Optionally, you can specify input_files or map_files for custom configs
}
parser = AdvancedAnalysisParser(request)
parser.run() # writes output to adv_output.json
# Or get result as dict:
result = parser.run(return_dict=True)
print(result)
Command-Line Usage
Create a config file (e.g. config.json):
{
"input_dir": "./Test",
"output_dir": "./Test",
"output_json": "adv_output.json"
}
Then run:
python -m AdvancedAnalysisFileParser.AdvancedAnalysisParser -c config.json
Configuration
The parser uses config files (JSON) to define how to parse and warn for each file type. Default configs are provided for:
- GBA:
gba_tsv_config.json - SMN:
smn_tsv_config.json - Oncology:
dragen_500_tsv_config.json - JSON:
dragen_targeted_config.json
You can override or extend these by providing your own config in the map_files key of the request.
Example request/config structure
| Key | Type | Description |
|---|---|---|
output_json |
string | Filename for the generated JSON (default: adv_analysis_output.json) |
input_dir |
string | Directory containing all input files |
input_files |
list | (Optional) List of files to parse |
map_files |
object | (Optional) Mapping of filenames → caller definitions |
Warnings
Warnings are generated automatically for each caller/file type, based on the config. Each config defines conditions for warnings (see *_config.json files for examples). You can customize these for your use case.
Testing
Run the test suite to validate all parsing and warning logic:
pytest AdvancedAnalysisFileParser/Test_AdvancedAnalysisParser.py
Or run the test script:
python AdvancedAnalysisFileParser/run_test_parser.py
Example Data
See the Test/ folder for example input files (TSV/JSON) and expected outputs.
License
MIT
Metadata
Release files for AdvancedAnalysisFileParser 0.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
Total release size: 37.8 MB
Release files / advancedanalysisfileparser-0.1.4-cp314-cp314-win_amd64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
71894acc3da608176778511e3335dd1dcdb27c9f399f90583e9fe33948b77b88
|
|
BLAKE2b-256 checksum How to use checksums |
b16e6051c54c815f80de7300cd98b04dec14e6951954dd8d1f46de3d27e51d93
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / advancedanalysisfileparser-0.1.4-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 3.9 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
c3f19a768ca4fdf04baf8a4e3b0bb597f12eb47e6c1486600ea3a88ad3c4a86f
|
|
BLAKE2b-256 checksum How to use checksums |
3332255ee19a40144d9c8c718ef87dcec74802d58a120dbd8e873ac10244bf3e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / advancedanalysisfileparser-0.1.4-cp314-cp314-macosx_10_15_x86_64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp314-cp314-macosx_10_15_x86_64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.14 macOS 10.15+ x86-64 |
|
SHA-256 checksum How to use checksums |
ad03c5074d391cedffe23bc2ed094fc3d42df8777b7e89dc381c465272d283be
|
|
BLAKE2b-256 checksum How to use checksums |
b6758263d9d6dcddb4a67f5ca33358ba958935e3617c39d950bc1b0c30876ccc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / advancedanalysisfileparser-0.1.4-cp313-cp313-win_amd64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
d4984bc89fa2b11ef2988a1da67cd3f8aaf0b588b66f7797918592d257f9bf77
|
|
BLAKE2b-256 checksum How to use checksums |
f252a2c30ae236a0787d3828fde2406482f0188b9ef017a4d65a9150eb40d753
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / advancedanalysisfileparser-0.1.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 3.9 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
54df9623840f470fcc64b2b97487d1a82af60f77f24e5ac86ce55bf3646621c4
|
|
BLAKE2b-256 checksum How to use checksums |
465ddda9bcdfd902b8d8f4c0ef598847ea02518a3b774e8c7dcd94caa543e275
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / advancedanalysisfileparser-0.1.4-cp313-cp313-macosx_10_13_x86_64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp313-cp313-macosx_10_13_x86_64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.13 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
f1336d26f324abbda1974f57fc2b82b8267b4b3fb890885c203b3a57707f4bae
|
|
BLAKE2b-256 checksum How to use checksums |
db9d9d22cad8c9380ab91a474eae142fa1a03fd889d4595a32d767a50df3a74f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / advancedanalysisfileparser-0.1.4-cp312-cp312-win_amd64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
96dcd4784a9f1720f68e39366deed79f3144b9bb9cbe88c5f31f2194d0a35a6d
|
|
BLAKE2b-256 checksum How to use checksums |
54e6c7a4c4d3515c619808e6f822d4edd4109fbdc0a1bb5096364900522dc50c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / advancedanalysisfileparser-0.1.4-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 4.0 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
f3e1308d1d38745db3ad8a77b7e89e2c1add700dace6f0d305cf5c2d3d34f9e3
|
|
BLAKE2b-256 checksum How to use checksums |
95d88427a06d1174dae2a71d274816f87bbaec397f1d0b21c2cd5326d6588251
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / advancedanalysisfileparser-0.1.4-cp312-cp312-macosx_10_13_x86_64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp312-cp312-macosx_10_13_x86_64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.12 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
31cf86a363d242be4d1701d612b84f9a1c6f6b95b4d938336b0b14884909dd08
|
|
BLAKE2b-256 checksum How to use checksums |
ee028e145e9ab37db55c19f21bd8c98f4d4f66ddda2d3d1180270757f015f2d6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / advancedanalysisfileparser-0.1.4-cp311-cp311-win_amd64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
04bad581ad6ebefeb13fdc50595e8ed76ba272326eef2697d7804b85101795aa
|
|
BLAKE2b-256 checksum How to use checksums |
a060d9ed8c0a9287da0b666112587dc82b2dc87b313ce5bfc0a6379f46107e6f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / advancedanalysisfileparser-0.1.4-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 3.9 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
101ba5d4c75c894255d6f55180c200f2e60d3cdaa0ab67101f01088d0457e18e
|
|
BLAKE2b-256 checksum How to use checksums |
d4c3a826260c7a36dc350e73c73e39adb5a93db80e45515542e717e36725a95f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / advancedanalysisfileparser-0.1.4-cp311-cp311-macosx_10_9_x86_64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp311-cp311-macosx_10_9_x86_64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.11 macOS 10.9+ x86-64 |
|
SHA-256 checksum How to use checksums |
231a1c93fb6f10a66e25d4eabc753485369161638521d6e8c6893690834059e9
|
|
BLAKE2b-256 checksum How to use checksums |
c8ce3e4493c569dd5ad61358c46842a260d907e483dd34c54fad0b0634035e93
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / advancedanalysisfileparser-0.1.4-cp310-cp310-win_amd64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
b86f5dc305e95ac12507b9a89f2f650b5135cc6c1a3d81a496faf44f148336e8
|
|
BLAKE2b-256 checksum How to use checksums |
99224a059ce721810ca6e2fb0fbfffe9edb98591f9d8ec91429f6bd587fed498
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / advancedanalysisfileparser-0.1.4-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
f82033d166f3f0faa68c4d8de0b9404394f69f525f1338cb936330766164c216
|
|
BLAKE2b-256 checksum How to use checksums |
b4d6572abd137d210893af7f1128efe287e06a3baaff3f6ec6ab0282967e38a2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / advancedanalysisfileparser-0.1.4-cp310-cp310-macosx_10_9_x86_64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp310-cp310-macosx_10_9_x86_64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.10 macOS 10.9+ x86-64 |
|
SHA-256 checksum How to use checksums |
5d15c4a89aacdd7053a5c6e6da2c7cf0e94cc0003a7718b9d88cfa0cb445f236
|
|
BLAKE2b-256 checksum How to use checksums |
533cd00afcebeafadc3a63268b04853d99e8cfb2eb2d2086be5062421ba2f630
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / advancedanalysisfileparser-0.1.4-cp39-cp39-win_amd64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp39-cp39-win_amd64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.9 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
25b63ddd468f386a8ee5163cec6b678f06bd5e20bc25d5ec1bd5c67997b1bc4a
|
|
BLAKE2b-256 checksum How to use checksums |
20b1ab577f6e4c6fe4de6107628cc62e4396329dfb326fc1fbb83c22643b4199
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / advancedanalysisfileparser-0.1.4-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | CPython 3.9 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
114e36aa38f050645416533152b2ebcaeb6c4a62822ffbe97c54c450c2ff61a5
|
|
BLAKE2b-256 checksum How to use checksums |
eae8510f2078da79654356cc60e59ff7a1b5057ac3aacc682d461ae1fde70409
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / advancedanalysisfileparser-0.1.4-cp39-cp39-macosx_10_9_x86_64.whl
| Download URL | advancedanalysisfileparser-0.1.4-cp39-cp39-macosx_10_9_x86_64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.9 macOS 10.9+ x86-64 |
|
SHA-256 checksum How to use checksums |
411139129a390e5e5b1d7dcab41fc52f94f743984067c789d65cccdd5c38f788
|
|
BLAKE2b-256 checksum How to use checksums |
74e129388ebd799eced9e4a2884b4082595cbdd0386a3adbe29cfff0920d98eb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Security for AdvancedAnalysisFileParser 0.1.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.