{
    "info": {
        "author": "Edward Banner",
        "author_email": "edward.banner@gmail.com",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "# RobotReviewer\nAutomatic extraction of data from clinical trial reports\n\nA simple webserver written in Python which accepts a clinical trial (in plain text/JSON), and returns risk of bias judgements.\n\nThe current release has a DOI: [![DOI](https://zenodo.org/badge/15498/ijmarshall/robotreviewer.svg)](https://zenodo.org/badge/latestdoi/15498/ijmarshall/robotreviewer)\n\n## Systematic review author?\n\nThis software is the *web-service* version, meaning it's aimed at people who make systematic review software.\n\n**For most systematic review authors, if you want to try out RobotReviewer, you'd probably be better using the demo version on our website, available [here](https://robot-reviewer.vortext.systems).** If you like it, you could email the person who maintains your systematic review software a link to this site - they might be interested in adding it.\n\n(Alternatively, individual authors who are adept at installing unix software from the terminal are free to install this version on their own machines by following the optional 'Web UI' instructions below).\n\n## Developers of systematic review software?\n\nYou may also use RobotReviewer free of charge, but with the following conditions:\n\n1. You display the text, 'Risk of Bias automation by RobotReviewer ([how to cite](http://vortext.systems/robotreviewer))' on the same screen or webpage on which the RobotReviewer results (highlighted text or risk of bias judgements) are displayed.\n2. For web-based tools, the text 'how to cite' should link to our website `http://vortext.systems/robotreviewer`\n3. For desktop software, you should usually link to the same website. If this is not possible, you may alternately display the text and example citations from the 'How to cite RobotReviewer' section below.\n\n## How to cite RobotReviewer\n\nWe offer RobotReviewer free of charge, but we'd be most grateful if you would cite us if you use it. We're academics, and thrive on links and citations!\n\nGetting RobotReviewer widely used and cited helps us obtain the funding to maintain the project and make RobotReviewer better.\n\nIt also makes your methods transparent to your readers, and not least we'd love to see where RobotReviewer is used! :)\n\nYou can cite RobotReviewer as:\n\nMarshall IJ, Kuiper J, & Wallace BC. RobotReviewer: evaluation of a system for automatically assessing bias in clinical trials. Journal of the American Medical Informatics Association 2015. [doi:10.1093/jamia/ocv044](http://dx.doi.org/10.1093/jamia/ocv044)\n\nA BibTeX entry for LaTeX users is\n\n    @article{RobotReviewer2015,\n      title = {{RobotReviewer: evaluation of a system for automatically assessing bias in clinical trials}},\n      author = {Marshall, Iain J and Kuiper, Jo\\\"{e}l and Wallace, Byron C},\n      doi = {10.1093/jamia/ocv044},\n      url = {http://dx.doi.org/10.1093/jamia/ocv044},\n      journal = {Journal of the American Medical Informatics Association},\n      year = {2015}\n      month = jun,\n      pages = {ocv044}\n    }\n\n## Dependencies\n\nRobotReviewer requires the following libraries:\n\n    sklearn\n    numpy\n    scipy\n    hickle\n    nltk\n\n`nltk` and `sklearn` are not used much, and will be removed in time\n\n\n    pip install numpy scipy sklearn hickle nltk\n\n## Running\n\n`python robot.py` will start a flask server running on `localhost:5000`. You can run the server in development mode by passing `DEBUG=true python robot.py` which will attempt live code reload.\n\n## Running the Web UI\n\nThe optional web interface is provided by [Vortext](http://vortext.systems) [Sp\u00e1](https://github.com/vortext/spa).\nIt can be installed by running the following commands:\n\n```bash\ngit submodule update --init --recursive\npython robot.py\n```\n\nThis retrieves the front-end code, and runs the server.\n\n## Input/output\n\nSend some JSON by POST to /annotate such as:\n```json\n{\"text\": \"Put the full text of a clinical trial in here\"}\n```\n\nand it will return something like:\n\n```json\n{\"marginalia\": [\n   {\"title\":\"Random sequence generation\",\n    \"type\":\"Risk of Bias\",\n    \"description\":\"**Overall risk of bias prediction**: low\",\n    \"annotations\":[\n       {\"content\":\"A central pharmacy randomly assigned study medication in a 1:1 ratio using a computer-generated randomization sequence with variable-sized blocks ranging from 2 to 8 stratified by study site.\",\n        \"uuid\":\"6e97f8d0-2970-11e5-b5fe-0242ac110006\"\n       }, ...\n```\n\n## Running as a Python module\n\nWe will add full python module functionality to a future relase. However, the current code can easily be called directly from existing python code as follows:\n\n```python\nimport biasrobot # from the robotreviewer root directory\n\nbot = biasrobot.BiasRobot()\ntext = \"Put the full text of a clinical trial in here...\"\nannotations = bot.annotate(text)\n```\n\nWhere the BiasRobot.annotate() method returns a \"marginalia\" dict of the same structure as the JSON example above.\n\n## Help\n\nFeel free to contact us on [mail@ijmarshall.com](mailto:mail@ijmarshall.com) with any questions.\n\n## More help!\n\nOur tech consultancy [Vortext](http://vortext.systems/) can help get RobotReviewer running on your server for you, or can provide fully-managed RobotReviewer cloud instances; [contact us](http://vortext.systems/hire-us/) for details.\n\n## References\n\n1. Marshall, I. J., Kuiper, J., & Wallace, B. C. (2015). RobotReviewer: evaluation of a system for automatically assessing bias in clinical trials. Journal of the American Medical Informatics Association. [[doi]](http://dx.doi.org/10.1093/jamia/ocv044)\n2. Marshall, I., Kuiper, J., & Wallace, B. (2015). Automating Risk of Bias Assessment for Clinical Trials. IEEE Journal of Biomedical and Health Informatics. [[doi]](http://dx.doi.org/10.1109/JBHI.2015.2431314)\n3. Kuiper, J., Marshall, I. J., Wallace, B. C., & Swertz, M. A. (2014). Sp\u00e1: A Web-Based Viewer for Text Mining in Evidence Based Medicine. In Proceedings of the European Conference on Machine Learning and Principles and Practice of Knowledge Discovery in Databases (ECML-PKDD 2014) (Vol. 8726, pp. 452\u2013455). Springer Berlin Heidelberg. [[doi]](http://dx.doi.org/10.1007/978-3-662-44845-8_33)\n4. Marshall, I. J., Kuiper, J., & Wallace, B. C. (2014). Automating Risk of Bias Assessment for Clinical Trials. In Proceedings of the ACM Conference on Bioinformatics, Computational Biology, and Health Informatics (ACM-BCB) (pp. 88\u201395). ACM. [[doi]](http://dx.doi.org/10.1145/2649387.2649406)\n\n## License\n\nCopyright (c) 2015 Iain Marshall, Jo\u00ebl Kuiper, and Byron Wallace; All rights reserved",
        "description_content_type": null,
        "docs_url": null,
        "download_url": "UNKNOWN",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/ijmarshall/robotreviewer",
        "keywords": null,
        "license": "GPL",
        "maintainer": null,
        "maintainer_email": null,
        "name": "robotreviewer",
        "package_url": "https://pypi.org/project/robotreviewer/",
        "platform": "UNKNOWN",
        "project_url": "https://pypi.org/project/robotreviewer/",
        "project_urls": {
            "Download": "UNKNOWN",
            "Homepage": "https://github.com/ijmarshall/robotreviewer"
        },
        "release_url": "https://pypi.org/project/robotreviewer/0.0.4/",
        "requires_dist": null,
        "requires_python": null,
        "summary": "Automatic extraction of data from clinical trial reports",
        "version": "0.0.4"
    },
    "last_serial": 1943757,
    "releases": {
        "0.0.1": [],
        "0.0.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "d5320963167c7edde71f6b3f8a9f6afd",
                    "sha256": "ff43fc8b0822c5c0224e00063489620440fd97774a82ddb180fa512a3aca7d38"
                },
                "downloads": -1,
                "filename": "robotreviewer-0.0.2.tar.gz",
                "has_sig": false,
                "md5_digest": "d5320963167c7edde71f6b3f8a9f6afd",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 5318,
                "upload_time": "2016-02-07T01:46:16",
                "url": "https://files.pythonhosted.org/packages/06/45/d5f28adc421396496a98740b238d57e24ab41e6b8b461edd364fb47ceab8/robotreviewer-0.0.2.tar.gz"
            }
        ],
        "0.0.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "05de8e39eec686b6e44f6ae617c6939d",
                    "sha256": "afd8c20d4dabb6899f256281b5d09bd464709bdac22e1575555a9287f4fd50cc"
                },
                "downloads": -1,
                "filename": "robotreviewer-0.0.3.tar.gz",
                "has_sig": false,
                "md5_digest": "05de8e39eec686b6e44f6ae617c6939d",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 5407,
                "upload_time": "2016-02-07T01:50:56",
                "url": "https://files.pythonhosted.org/packages/4c/0c/33ad0716b61e2391cf52039977f66b26b3eaa04ad3a23dacc98c299bc99f/robotreviewer-0.0.3.tar.gz"
            }
        ],
        "0.0.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "4c56f0e067a73c23438e4bdcc896791c",
                    "sha256": "ba3bde5efd27a240ce1677aa0fa94a2939ee4b4639a99da0f3a584759d37cc00"
                },
                "downloads": -1,
                "filename": "robotreviewer-0.0.4.tar.gz",
                "has_sig": false,
                "md5_digest": "4c56f0e067a73c23438e4bdcc896791c",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 13924,
                "upload_time": "2016-02-07T02:25:42",
                "url": "https://files.pythonhosted.org/packages/14/c2/773e23950ffb8b4d2eb635b05e26bd601498c3e717fbd05be2cc9ed47e72/robotreviewer-0.0.4.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "4c56f0e067a73c23438e4bdcc896791c",
                "sha256": "ba3bde5efd27a240ce1677aa0fa94a2939ee4b4639a99da0f3a584759d37cc00"
            },
            "downloads": -1,
            "filename": "robotreviewer-0.0.4.tar.gz",
            "has_sig": false,
            "md5_digest": "4c56f0e067a73c23438e4bdcc896791c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 13924,
            "upload_time": "2016-02-07T02:25:42",
            "url": "https://files.pythonhosted.org/packages/14/c2/773e23950ffb8b4d2eb635b05e26bd601498c3e717fbd05be2cc9ed47e72/robotreviewer-0.0.4.tar.gz"
        }
    ]
}