{
    "info": {
        "author": "Sven Fillinger",
        "author_email": "sven.fillinger@qbic.uni-tuebingen.de",
        "bugtrack_url": null,
        "classifiers": [
            "Intended Audience :: Developers",
            "License :: OSI Approved :: MIT License",
            "Programming Language :: Python",
            "Programming Language :: Python :: 3.4",
            "Programming Language :: Python :: 3.5",
            "Topic :: Scientific/Engineering :: Bio-Informatics",
            "Topic :: Software Development :: Libraries :: Python Modules"
        ],
        "description": "mtbconverter\n==============\n\n|language| |travis| |codecov| |ghtag| |pypi| |license| \n\nA Python command line tool that parses and converts diagnostic variant data for the Molecular Tumor Board at UKT T\u00fcbingen.\n\n.. |language| image:: https://img.shields.io/github/languages/top/qbicsoftware/qbic.mtbconverter.svg\n\n.. |travis| image:: https://travis-ci.org/qbicsoftware/qbic.mtbconverter.svg?branch=master\n    :target: https://travis-ci.org/qbicsoftware/qbic.mtbconverter\n.. |codecov| image:: https://codecov.io/gh/qbicsoftware/qbic.mtbconverter/branch/master/graph/badge.svg\n  :target: https://codecov.io/gh/qbicsoftware/qbic.mtbconverter\n.. |ghtag| image:: https://img.shields.io/github/release/qbicsoftware/qbic.mtbconverter/all.svg\n    :target: https://github.com/qbicsoftware/qbic.mtbconverter/releases\n.. |pypi| image:: https://img.shields.io/pypi/v/mtbconverter.svg\n    :target: https://pypi.python.org/pypi/mtbconverter\n.. |license| image:: https://img.shields.io/github/license/qbicsoftware/qbic.mtbconverter.svg\n\n\n.. contents:: Table of Contents\n   :depth: 2\n\n\nCommands\n---------\n\nIf you provide the ``-h`` argument, you get the command overview:\n\n.. code-block:: bash\n  \n  Mtbconverter version 0.1\n  Usage: mtbconverter.py [-h] [command]\n\n  command:\n          convert         Converts variant information into CentraXX XML.\n          push            Pushes one ore more XML files to CentraXX.\n          catalogue       Builds CentraXX catalogue XML files.\n\nThe mtbconverter currently supports three commands: ``convert, push`` and ``catalogue``.\n\nconvert\n~~~~~~~\nThe ``convert`` command tells the mtbconverter to parse the necessary MTB information from a given zip archive. The archive needs to contain several TSV files. which follow the format specification_ and naming convention described in the ``mtbparser`` module, which is implemented in mtbconverter.\n\n.. _specification: https://github.com/qbicsoftware/qbic.mtbparser/blob/master/README.md\n\n.. code-block:: bash\n\n  Mtbconverter version 0.1.\n  usage: convert [-h] archive patientID\n\n  Conversion of variant information into CentraXX schema conform XML.\n\n  positional arguments:\n    archive     ZIP archive containing the variant information files.\n    patientID   A QBiC patient ID.\n\n  optional arguments:\n    -h, --help  show this help message and exit\n    \nThe output is an XML according to the CetraXX DataExchange specification, that reflects the information parsed from the MTB ZIP archive and can be imported into CentraXX, for example with the ``mtbconverter push`` command.\n\n**Archive format specification**\nThe ZIP archive name needs to carry the QBIC barcode, and the same needs to present in all files within the archive. This is just to make sure, that the files indeed belong to the same sample.\n\n.. code-block:: bash\n  \n  Archive name:\n  <QBIC-barcode>_*.zip\n  \n  Archive content:\n  <QBiC-Barcode>_somatic_snv.tsv\n  <QBiC-Barcode>_somatic_cnv.tsv\n  <QBiC-Barcode>_germline_snv.tsv\n  <QBiC-Barcode>_germline_cnv.tsv\n  <QBiC-Barcode>_somatic_sv.tsv\n  <QBiC-Barcode>_metadata.tsv\n\nThe information is encoded in the six TSV files, following the specification described in detail in the ``mtbparser`` library_.\n\npush\n~~~~\nThe ``push`` command enables the import of a CentraXX patient XML into the CentraXX system via CentraXX's REST API. With the ``-h`` flag, you get an overview of the arguments:\n\n.. code-block:: bash\n\n    Mtbconverter version 0.1.\n    usage: push [-h] [-c config] [-t] [--check] patientdata\n\n    Import a converted XML file into CentraXX.\n\n    positional arguments:\n      patientdata  Converted XML file from an MTB ZIP archive with the variant\n                   information.\n\n    optional arguments:\n      -h, --help   show this help message and exit\n      -c config    Configuration file with settings for the remote CentraXX\n                   system. (Default: /etc/centraxx.config)\n      -t, --test   Import to the CentraXX test system.\n      --check      Check the connection to CentraXX.\n      \n``mtbconverter`` tries to parse a configuration file by default in ``/etc/centraxx.config``, but you can also specify another path via the ``-c`` option.\n\n**CentraXX configuration file**\nThe configuration file contains information about CentraXX's server location and authentication data. An example config file shall look similar to this:\n\n.. code-block:: bash\n\n    [CENTRAXX_TEST]\n    authuser=myuser\n    password=mypassword\n    serveraddr=127.0.0.1:443\n    protocol=https\n    infopath=%(protocol)s://%(serveraddr)s/centraxx/rest/info\n\n    [CENTRAXX]\n    authuser=myuser\n    password=mypassword\n    serveraddr=xxx.x.xxx.xxx:xxxx\n    protocol=https\n    infopath=%(protocol)s://%(serveraddr)s/centraxx/rest/info\n\nThe ``[...]`` parts are the sections of the configuration. ``mtbconverter`` currently supports \"CENTRAXX\" and \"CENTRAXX_TEST\".  If you specify the \"CENTRAXX_TEST\" section, then you can perform operations to a target test system using the ``-t`` option flag.\n\nIf you supply the ``infopath`` keyword with a valid path, you can check the connection to CentraXX easily by providing the ``--check`` option flag. Either you will get an timeout response, if the target server is not accessible, or you will see the return code with message.\n\ncatalogue\n~~~~~~~~~\nThe ``catalogue`` command creates XML files for CentraXX controlled vocabulary, parameters definition and profiles. This needs to be done only once every time a specification changes, so CentraXX knows how to connect the incoming data, once it gets imported.\n\nAfter executing ``catalogue``, mtbconverter will create 8 XML files:\n\n1. cv_centraxx.xml: The controlled vobaculary for CentraXX.\n2. params_centraxx.xml: The parameters and the expected data type for CentraXX.\n3. ssnv_profiles_centraxx.xml: The profile for somatic SNVs.\n4. scnv_profiles_centraxx.xml: The profile for somatic CNVs.\n5. gsnv_profiles_centraxx.xml: The profile for germline SNVs.\n6. gcnv_profiles_centraxx.xml: The profile for germline CNVs.\n7. sv_profiles_centraxx.xml: The profile for somatic structural variants.\n8. metadata_profiles_centraxx.xml: The profile for metadata, containing the diagnosis.\n\n\nChangelog\n---------\nFind all the version changes of ``mtbconverter`` here\n\n2018-02-07: v0.1.1\n~~~~~~~~~\nSmall bug fixes, add entry point, so mtbconverter can be used as command line tool\n\n2018-02-06: v0.1\n~~~~~~~~~\nFirst official release, not yet supporting all of the desired push options to CentraXX, but coming soon!\n\nAuthor\n------\nThis code is provided by Sven Fillinger, QBiC, University of T\u00fcbingen.\n\n\n.. _library: https://github.com/qbicsoftware/qbic.mtbparser/blob/master/README.md",
        "description_content_type": "",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/qbicsoftware/qbic.mtbconverter",
        "keywords": "",
        "license": "MIT",
        "maintainer": "",
        "maintainer_email": "",
        "name": "mtbconverter",
        "package_url": "https://pypi.org/project/mtbconverter/",
        "platform": "",
        "project_url": "https://pypi.org/project/mtbconverter/",
        "project_urls": {
            "Homepage": "https://github.com/qbicsoftware/qbic.mtbconverter"
        },
        "release_url": "https://pypi.org/project/mtbconverter/0.1.3/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "A Python command line tool that parses and converts diagnostic variant data for the Molecular Tumor Board at UKT T\u00fcbingen.",
        "version": "0.1.3"
    },
    "last_serial": 3861009,
    "releases": {
        "0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "3f793732fcf471213ead8bf29f51fe85",
                    "sha256": "bbcbeb2b16bc03c6d0034d19d5069e6bfab9ab6787e02a5ebe00ac6f3beb842c"
                },
                "downloads": -1,
                "filename": "mtbconverter-0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "3f793732fcf471213ead8bf29f51fe85",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 368429,
                "upload_time": "2018-02-06T15:27:29",
                "url": "https://files.pythonhosted.org/packages/eb/62/262afba99f43e5fc452a68d3e67c8159f3549de3178c8400fcc317e44503/mtbconverter-0.1.tar.gz"
            }
        ],
        "0.1.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "c1b66aaed7e2ccc5da2c58b789a7c2b0",
                    "sha256": "a74e5d05db934cf29e2763d29d8c399626b9d3ff40502b029483d6caa34f9246"
                },
                "downloads": -1,
                "filename": "mtbconverter-0.1.1.tar.gz",
                "has_sig": false,
                "md5_digest": "c1b66aaed7e2ccc5da2c58b789a7c2b0",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 368658,
                "upload_time": "2018-02-07T14:21:23",
                "url": "https://files.pythonhosted.org/packages/f1/08/eb7f02ce72069f2c565a2e33b83f68b310012a918f77554e83a16ba02712/mtbconverter-0.1.1.tar.gz"
            }
        ],
        "0.1.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "da8f6b57612264ff145d34e67c1763f0",
                    "sha256": "00d171e7aa2bc098af21768f69818233cf5c1cf22523ee5be1dd27ec139d167c"
                },
                "downloads": -1,
                "filename": "mtbconverter-0.1.2.tar.gz",
                "has_sig": false,
                "md5_digest": "da8f6b57612264ff145d34e67c1763f0",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 384808,
                "upload_time": "2018-04-05T12:31:12",
                "url": "https://files.pythonhosted.org/packages/7d/51/70f209da8086218eadbfbe71948ec6013c286ead9124cba3a32ae241229a/mtbconverter-0.1.2.tar.gz"
            }
        ],
        "0.1.2.dev0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "5888a6d1c00f4d920638126680435384",
                    "sha256": "b4fae9d2df7b2117af18389dc68111ddfc4ac78b1abf4f3c7b0dbeb80de86772"
                },
                "downloads": -1,
                "filename": "mtbconverter-0.1.2.dev0.tar.gz",
                "has_sig": false,
                "md5_digest": "5888a6d1c00f4d920638126680435384",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 384822,
                "upload_time": "2018-04-05T12:26:55",
                "url": "https://files.pythonhosted.org/packages/13/92/6dfffa18bbd28177b6ff1b25f5045afce48eb44da5c49a224f6610873cc1/mtbconverter-0.1.2.dev0.tar.gz"
            }
        ],
        "0.1.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "41f8ab4e9bc2f5c9f9dc22b279945ccc",
                    "sha256": "6442e044294f1b38c436b234e6578977c25e4c2ec6d8b3c622302ff24ffb61b5"
                },
                "downloads": -1,
                "filename": "mtbconverter-0.1.3.tar.gz",
                "has_sig": false,
                "md5_digest": "41f8ab4e9bc2f5c9f9dc22b279945ccc",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 384817,
                "upload_time": "2018-05-14T13:37:49",
                "url": "https://files.pythonhosted.org/packages/1a/33/ea8d96ad397faab837def0d4334303ef35f4bbab39815c660e9a221f5443/mtbconverter-0.1.3.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "41f8ab4e9bc2f5c9f9dc22b279945ccc",
                "sha256": "6442e044294f1b38c436b234e6578977c25e4c2ec6d8b3c622302ff24ffb61b5"
            },
            "downloads": -1,
            "filename": "mtbconverter-0.1.3.tar.gz",
            "has_sig": false,
            "md5_digest": "41f8ab4e9bc2f5c9f9dc22b279945ccc",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 384817,
            "upload_time": "2018-05-14T13:37:49",
            "url": "https://files.pythonhosted.org/packages/1a/33/ea8d96ad397faab837def0d4334303ef35f4bbab39815c660e9a221f5443/mtbconverter-0.1.3.tar.gz"
        }
    ]
}