Skip to main content

AdvancedAnalysisFileParser

PyPI version

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)

Table of built distributions (wheels) for AdvancedAnalysisFileParser 0.1.4
File Actions
advancedanalysisfileparser-0.1.4-cp314-cp314-win_amd64.whl CPython 3.14 CPython 3.14 Windows x86-64 Details for advancedanalysisfileparser-0.1.4-cp314-cp314-win_amd64.whl
advancedanalysisfileparser-0.1.4-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl CPython 3.14 CPython 3.14 Linux glibc 2.17+ x86-64, Linux glibc 2.28+ x86-64 Details for advancedanalysisfileparser-0.1.4-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
advancedanalysisfileparser-0.1.4-cp314-cp314-macosx_10_15_x86_64.whl CPython 3.14 CPython 3.14 macOS 10.15+ x86-64 Details for advancedanalysisfileparser-0.1.4-cp314-cp314-macosx_10_15_x86_64.whl
advancedanalysisfileparser-0.1.4-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details for advancedanalysisfileparser-0.1.4-cp313-cp313-win_amd64.whl
advancedanalysisfileparser-0.1.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.17+ x86-64, Linux glibc 2.28+ x86-64 Details for advancedanalysisfileparser-0.1.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
advancedanalysisfileparser-0.1.4-cp313-cp313-macosx_10_13_x86_64.whl CPython 3.13 CPython 3.13 macOS 10.13+ x86-64 Details for advancedanalysisfileparser-0.1.4-cp313-cp313-macosx_10_13_x86_64.whl
advancedanalysisfileparser-0.1.4-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details for advancedanalysisfileparser-0.1.4-cp312-cp312-win_amd64.whl
advancedanalysisfileparser-0.1.4-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.17+ x86-64, Linux glibc 2.28+ x86-64 Details for advancedanalysisfileparser-0.1.4-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
advancedanalysisfileparser-0.1.4-cp312-cp312-macosx_10_13_x86_64.whl CPython 3.12 CPython 3.12 macOS 10.13+ x86-64 Details for advancedanalysisfileparser-0.1.4-cp312-cp312-macosx_10_13_x86_64.whl
advancedanalysisfileparser-0.1.4-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details for advancedanalysisfileparser-0.1.4-cp311-cp311-win_amd64.whl
advancedanalysisfileparser-0.1.4-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.17+ x86-64, Linux glibc 2.28+ x86-64 Details for advancedanalysisfileparser-0.1.4-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
advancedanalysisfileparser-0.1.4-cp311-cp311-macosx_10_9_x86_64.whl CPython 3.11 CPython 3.11 macOS 10.9+ x86-64 Details for advancedanalysisfileparser-0.1.4-cp311-cp311-macosx_10_9_x86_64.whl
advancedanalysisfileparser-0.1.4-cp310-cp310-win_amd64.whl CPython 3.10 CPython 3.10 Windows x86-64 Details for advancedanalysisfileparser-0.1.4-cp310-cp310-win_amd64.whl
advancedanalysisfileparser-0.1.4-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl CPython 3.10 CPython 3.10 Linux glibc 2.17+ x86-64, Linux glibc 2.28+ x86-64 Details for advancedanalysisfileparser-0.1.4-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
advancedanalysisfileparser-0.1.4-cp310-cp310-macosx_10_9_x86_64.whl CPython 3.10 CPython 3.10 macOS 10.9+ x86-64 Details for advancedanalysisfileparser-0.1.4-cp310-cp310-macosx_10_9_x86_64.whl
advancedanalysisfileparser-0.1.4-cp39-cp39-win_amd64.whl CPython 3.9 CPython 3.9 Windows x86-64 Details for advancedanalysisfileparser-0.1.4-cp39-cp39-win_amd64.whl
advancedanalysisfileparser-0.1.4-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl CPython 3.9 CPython 3.9 Linux glibc 2.17+ x86-64, Linux glibc 2.28+ x86-64 Details for advancedanalysisfileparser-0.1.4-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
advancedanalysisfileparser-0.1.4-cp39-cp39-macosx_10_9_x86_64.whl CPython 3.9 CPython 3.9 macOS 10.9+ x86-64 Details for advancedanalysisfileparser-0.1.4-cp39-cp39-macosx_10_9_x86_64.whl

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page