{ "info": { "author": "Bo Gao", "author_email": "kaye_gao@hotmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Science/Research", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3.6", "Topic :: Scientific/Engineering :: Bio-Informatics" ], "description": "Mecan4CNA\n=========\n\nA copy number profile usually needs to be calibrated for the position of\nbaseline (normal copy numbers) due to sample impurity and measurement\nbias. It\u2019s crucial to normalize CN profiles when comparing them in\nanalysis, because usually each profile has a different signal scale.\n\nMecan4CNA (Minimum Error Calibration and Normalization for Copy Number\nAnalysis) uses an algebraic method to estimate the baseline and the\ndistance between DNA levels (referred to as level distance). It can be\nused for both single file analysis and multi-file normalization.\n\nKey features:\n\n- Calibration of a segmentation file, so that the signal of normal is\n aligned to 2 (0 in log2)\n- Estimation of the distance between DNA levels\n- Normalizing multiple files to a uniformed signal scale, so that 3\n (0.585 in log2) and 1 (-1 in log2) actually correspond to one copy\n gain and one copy lost\n- Needs only a segmentation file (from any platform)\n- Detailed results and plots for in-depth analysis\n- Fast\n\nHow to install\n--------------\n\nThe easiest way is to install through pip:\n\n::\n\n pip install mecan4cna\n mecan4cna --help\n\nHow to use\n----------\n\nSee the\n`manual `__\nfor details.\n\nQuick start\n~~~~~~~~~~~\n\n::\n\n mecan4can -i [SEGMENT_FILE] -o [OUTPUT_PATH]\n\nDemo mode\n~~~~~~~~~\n\n::\n\n mecan4can --demo\n\nThis will copy 5 example files to the current directory and run with\ndefault settings. It invokes the ``run_mecan_example.sh`` script, which\nwill also be copied over and can be used as a template for customized\nanalysis.\n\nGeneral Usage\n~~~~~~~~~~~~~\n\n::\n\n Usage: mecan4cna [OPTIONS]\n\n Options:\n -i, --input_file FILENAME The input file.\n -o, --output_path TEXT The path for output files.\n -n, --normalize Calibrate and normalize the input file.\n -p, --plot Whether to save the signal histogram.\n -b, --bins_per_interval INTEGER RANGE\n The number of bins in each copy number\n interval.\n -v, --intervals INTEGER RANGE The number of copy number intervals.\n --demo Copy example files and run a demo script in\n the current directory.\n -pt, --peak_thresh INTEGER RANGE\n The minimum probes of a peak.\n -st, --segment_thresh INTEGER RANGE\n The minimum probes of a segment.\n --model_steps INTEGER RANGE The incremental step size in modeling.\n --mpd_coef FLOAT Minimum Peak Distance coefficient in peak\n detection.\n --max_level_distance FLOAT The maximum value of level distance.\n --min_level_distance FLOAT The minimum value of level distance.\n --min_model_score INTEGER RANGE\n The minimum value of the model score.\n --info_lost_ratio_thresh FLOAT The threshold of information lost ratio.\n --info_lost_range_low FLOAT The low end of information lost range.\n --info_lost_range_high FLOAT The high end of information lost range.\n --ld_scaler FLOAT The scaler of level distance in\n normalization.\n --help Show this message and exit.\n\nRequired options are:\n\n- ``-i FILENAME``\n- ``-o OUTPUTPATH``\n\nInput file format\n~~~~~~~~~~~~~~~~~\n\nThe input should be a segmentation file:\n\n- have at least **5** columns\uff1aid, chromosome, start, end, probes and\n value (in exact order, names do not matter). Any additional columns\n will be ignored.\n- the first line of the file is assumed to be column names, and will be\n ignored. Do not put empty lines at the beginning of the file.\n- be **tab separated**, without quoted values\n\nAn example:\n\n::\n\n id chro start end num_probes seg_mean\n GSM378022 1 775852 143752373 9992 0.025\n GSM378022 1 143782024 214220966 6381 0.1607\n GSM378022 2 88585000 144628991 4256 0.0131\n GSM378022 2 144635510 146290468 146 0.1432\n GSM378022 3 48603 8994748 1469 0.0544\n\nOutput files\n~~~~~~~~~~~~\n\n4 files will be created in the output path. If mecan fails to detect\nanything (not enough aberrant segments or no valid models), only the\nhistogram will be created:\n\n- base_level.txt : contains the estimated baseline and level distance.\n- histogram.pdf : a visual illustration of signal distributions.\n- models.tsv : a tab separated table that details all information of\n all models.\n- peaks.tsv : a tab separated table shows the determined signal peaks\n and their relative DNA levels compared to the baseline.\n\nCalibration and normalization\n-----------------------------\n\nWith the ``-n`` flag, the input file will be normalized and saved as\n``normalized.tsv``.\n\nImport as a python library\n--------------------------\n\n.. code:: python\n\n import mecan4can.algorithms as alg\n import mecan4can.common as comm\n\n with open('examples\\segment_example_1.tsv', 'r') as fin:\n segments = comm.file2list(fin)\n m = alg.mecan()\n r = m.run(segments)\n\nCommon problems\n---------------\n\nError of matplotlib\n~~~~~~~~~~~~~~~~~~~\n\nIt seems there is a bug in the latest version (3.0.3) of matplotlib,\nwhich may cause problems in OSX. Mecan uses an older verison of\nmatplotlib (2.0.2) to avoid this problem. If you need to use the latest\nversion and run into runtime problems, please check the following links.\n\n- `matplotlib\n documentation `__\n- `matplotlib github\n discussion `__", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/baudisgroup/mecan4cna", "keywords": "calibration normalization copy number", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "mecan4cna", "package_url": "https://pypi.org/project/mecan4cna/", "platform": "", "project_url": "https://pypi.org/project/mecan4cna/", "project_urls": { "Homepage": "https://github.com/baudisgroup/mecan4cna" }, "release_url": "https://pypi.org/project/mecan4cna/0.27/", "requires_dist": null, "requires_python": ">=3.6", "summary": "Minimum Error Calibration and Normalization for Copy Number Analysis", "version": "0.27" }, "last_serial": 5923386, "releases": { "0.10": [ { "comment_text": "", "digests": { "md5": "2406e0d001dd80e8317fb3e90c000aaf", "sha256": "50a77ad8c1c85ca96a6c1f5e4f532e9421b11e9b2ab40b805fd52b2c67652c54" }, "downloads": -1, "filename": "mecan4cna-0.10.tar.gz", "has_sig": false, "md5_digest": "2406e0d001dd80e8317fb3e90c000aaf", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 10589, "upload_time": "2019-04-25T15:19:45", "url": "https://files.pythonhosted.org/packages/a3/1b/130cbb750870548174d2a2a5675fa95e0bfbafa93a8a43d87e2b6a70b556/mecan4cna-0.10.tar.gz" } ], "0.11": [ { "comment_text": "", "digests": { "md5": "f5195d4a0dd1e7fb463833c8dab05c2d", "sha256": "7eb25d81421c0733b445917e13d19e45503523388dd7307b905ce9ff64733575" }, "downloads": -1, "filename": "mecan4cna-0.11.tar.gz", "has_sig": false, "md5_digest": "f5195d4a0dd1e7fb463833c8dab05c2d", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 10592, "upload_time": "2019-04-25T15:39:24", "url": "https://files.pythonhosted.org/packages/7f/cc/782c216f6b7f9847783c1b9e01fab070989a92e678fb9403f3e472733251/mecan4cna-0.11.tar.gz" } ], "0.12": [ { "comment_text": "", "digests": { "md5": "072ce31bf7991858a16a880020e0b089", "sha256": "9c7cb81a8b22a42dd5df7aed0d18d60f9003e49bb887c31bd2d3875408c69590" }, "downloads": -1, "filename": "mecan4cna-0.12.tar.gz", "has_sig": false, "md5_digest": "072ce31bf7991858a16a880020e0b089", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 11342, "upload_time": "2019-04-25T15:55:28", "url": "https://files.pythonhosted.org/packages/83/e0/c608c8a691b0a0d5930d149a4e81df06475729218eb6395197a61831b87a/mecan4cna-0.12.tar.gz" } ], "0.13": [ { "comment_text": "", "digests": { "md5": "d6ee626d3b3ec8d007f6b8948b5bc0f9", "sha256": "8079b1ffc76af6160fbda7966b6173e35b8e4f5c4ba0b3e26b10a24d89a21095" }, "downloads": -1, "filename": "mecan4cna-0.13.tar.gz", "has_sig": false, "md5_digest": "d6ee626d3b3ec8d007f6b8948b5bc0f9", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 11349, "upload_time": "2019-04-25T15:57:58", "url": "https://files.pythonhosted.org/packages/1a/c7/21be0234e321f435e504f31ef423f97dee16f5dc5557b9a94f9fb04c1f8a/mecan4cna-0.13.tar.gz" } ], "0.14": [ { "comment_text": "", "digests": { "md5": "19a3bd8c74e6930fde9b3220f3d19ea2", "sha256": "3f7354f5772da3d6e02f769b41ee27264f13de3a1cb26ff3f6f2b1fea18dccce" }, "downloads": -1, "filename": "mecan4cna-0.14.tar.gz", "has_sig": false, "md5_digest": "19a3bd8c74e6930fde9b3220f3d19ea2", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 11376, "upload_time": "2019-04-25T16:38:28", "url": "https://files.pythonhosted.org/packages/07/49/5148ec455b437a88cd8cfbae6fd72f1c542326b9163195d03c6b52409b73/mecan4cna-0.14.tar.gz" } ], "0.15": [ { "comment_text": "", "digests": { "md5": "90be7d7c60e366f1359ace8f0ece5080", "sha256": "7d1888438e96c563557aaa0a94b3037bf391d80205803379e7abbba995f1dbcd" }, "downloads": -1, "filename": "mecan4cna-0.15.tar.gz", "has_sig": false, "md5_digest": "90be7d7c60e366f1359ace8f0ece5080", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 11380, "upload_time": "2019-04-25T16:41:29", "url": "https://files.pythonhosted.org/packages/94/99/646fa6b4cde3fe40e5320b064c1b6b809f15f805cb900401574c00756972/mecan4cna-0.15.tar.gz" } ], "0.16": [ { "comment_text": "", "digests": { "md5": "c16266cb68e8de3c2fef9d6411eb4d62", "sha256": "61c9d9b53db2bd7a7ab49be9f21a54d7768d378e23d24a0ee559b421fb69dcc2" }, "downloads": -1, "filename": "mecan4cna-0.16.tar.gz", "has_sig": false, "md5_digest": "c16266cb68e8de3c2fef9d6411eb4d62", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 11387, "upload_time": "2019-04-25T16:42:35", "url": "https://files.pythonhosted.org/packages/62/e2/d80d936d93a18d55a13fe22d203d1e554a845fbb09769e1e0c3629e40182/mecan4cna-0.16.tar.gz" } ], "0.17": [ { "comment_text": "", "digests": { "md5": "419e1f6b86a675cc1ec1de85370a7848", "sha256": "d0f82d8798394736c6bfe406f41fcfda535310eb7d3ee4fdadd5b3bfdfce7a4e" }, "downloads": -1, "filename": "mecan4cna-0.17.tar.gz", "has_sig": false, "md5_digest": "419e1f6b86a675cc1ec1de85370a7848", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 11378, "upload_time": "2019-04-25T17:05:18", "url": "https://files.pythonhosted.org/packages/95/06/adc3481027fd3f2258d8e765928af9642f18d8198862a0b59d672061d236/mecan4cna-0.17.tar.gz" } ], "0.18": [ { "comment_text": "", "digests": { "md5": "90f001235026fe6a75aeac9fd914ec00", "sha256": "6bdf0748ae5726fa34bc88889b2a695043b4ff1d603fce5f3ad3d662f9902090" }, "downloads": -1, "filename": "mecan4cna-0.18.tar.gz", "has_sig": false, "md5_digest": "90f001235026fe6a75aeac9fd914ec00", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 13697, "upload_time": "2019-04-29T13:38:02", "url": "https://files.pythonhosted.org/packages/51/5a/16dc690de9f996fef300df2fc1c422dbd53454314a76caa52143e7a11b01/mecan4cna-0.18.tar.gz" } ], "0.19": [ { "comment_text": "", "digests": { "md5": "e5d1f532bb03f6737e8cdddaa6da6eda", "sha256": "3c17767a12cfd7518bcf27dba826959586d9464f76047d74670f6f69d715f852" }, "downloads": -1, "filename": "mecan4cna-0.19.tar.gz", "has_sig": false, "md5_digest": "e5d1f532bb03f6737e8cdddaa6da6eda", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 60940, "upload_time": "2019-04-29T13:48:53", "url": "https://files.pythonhosted.org/packages/6d/53/03adec5d3128dbd8c67d3d16d17611d9eec7ed7de4656870debc4e08de38/mecan4cna-0.19.tar.gz" } ], "0.20": [ { "comment_text": "", "digests": { "md5": "7ca693510d46b2a347732441e6745ac2", "sha256": "10405d9116509fe539b5b49ec04df43e811dc5fe1264da95e11e60b7eb6f559e" }, "downloads": -1, "filename": "mecan4cna-0.20.tar.gz", "has_sig": false, "md5_digest": "7ca693510d46b2a347732441e6745ac2", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 61280, "upload_time": "2019-04-29T13:51:17", "url": "https://files.pythonhosted.org/packages/12/2b/44e55583dbb2aeb02a4a0af83fbd9edc63a991157b0ff8c5cb01e2886dae/mecan4cna-0.20.tar.gz" } ], "0.21": [ { "comment_text": "", "digests": { "md5": "8c0601901adee25ebfcf2d105fa6fd0c", "sha256": "f34a612eed2cd40457c0a1f9dafdfef0ccc7b6fa861e784c9c29e519adfdec5f" }, "downloads": -1, "filename": "mecan4cna-0.21.tar.gz", "has_sig": false, "md5_digest": "8c0601901adee25ebfcf2d105fa6fd0c", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 61404, "upload_time": "2019-04-29T14:53:30", "url": "https://files.pythonhosted.org/packages/da/7e/669c521693deb28c41353610856f0fd2f01e1e148de76ab3ebc95fdee3ad/mecan4cna-0.21.tar.gz" } ], "0.22": [ { "comment_text": "", "digests": { "md5": "ba04fa15baa7343a393ef1dacca61fec", "sha256": "f5b8fe6f9d897936ef0148a1be83ff965c6f7bb50b4b03af5fdec8309343d9ec" }, "downloads": -1, "filename": "mecan4cna-0.22.tar.gz", "has_sig": false, "md5_digest": "ba04fa15baa7343a393ef1dacca61fec", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 62136, "upload_time": "2019-04-30T13:04:15", "url": "https://files.pythonhosted.org/packages/99/33/013158afce2243fb1e123e2006f5cc5599b42a95a4d059371b13c5bda433/mecan4cna-0.22.tar.gz" } ], "0.24": [ { "comment_text": "", "digests": { "md5": "a85c8ce7d5d8102f556ccc53a38b47fa", "sha256": "0f669934cee51455ee12aed20c97f4c30191fa8c28ceec795b74ae27cae689df" }, "downloads": -1, "filename": "mecan4cna-0.24.tar.gz", "has_sig": false, "md5_digest": "a85c8ce7d5d8102f556ccc53a38b47fa", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 62155, "upload_time": "2019-05-08T09:06:40", "url": "https://files.pythonhosted.org/packages/5b/bc/d2be6cf7e10e2ab33473161cca8cdaf09afa5543ea3b312107d63775f896/mecan4cna-0.24.tar.gz" } ], "0.25": [ { "comment_text": "", "digests": { "md5": "f0935b543f82ec72d55039dc3ad73183", "sha256": "767c8df840b468f3e09d01785fe752392b94b1a37927d6907e5a31825a382ea4" }, "downloads": -1, "filename": "mecan4cna-0.25.tar.gz", "has_sig": false, "md5_digest": "f0935b543f82ec72d55039dc3ad73183", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 62078, "upload_time": "2019-08-26T12:50:32", "url": "https://files.pythonhosted.org/packages/07/74/836e12f9b1cef26ebd4f0e6cfc234393867a006e8c449a3d617edd3afa95/mecan4cna-0.25.tar.gz" } ], "0.26": [ { "comment_text": "", "digests": { "md5": "a0b2399c3dfe4bf4f3bd2a59fc9bc070", "sha256": "f304174c6a5379d97cce9b6684cde52e785a641b7897c196b2d5f77090a69560" }, "downloads": -1, "filename": "mecan4cna-0.26.tar.gz", "has_sig": false, "md5_digest": "a0b2399c3dfe4bf4f3bd2a59fc9bc070", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 62586, "upload_time": "2019-09-03T08:32:00", "url": "https://files.pythonhosted.org/packages/51/18/05a4ec6158422e0bc08b6da8bae81da9e1b41a27d2b8b532e1385a4d2adc/mecan4cna-0.26.tar.gz" } ], "0.27": [ { "comment_text": "", "digests": { "md5": "39d2e34aa70f18fcefe65b3850d773c2", "sha256": "edf139a3dd2d9daf0c08b3b2229c5372276ae8f0daa6426b7fdebea607c05f8f" }, "downloads": -1, "filename": "mecan4cna-0.27.tar.gz", "has_sig": false, "md5_digest": "39d2e34aa70f18fcefe65b3850d773c2", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 62585, "upload_time": "2019-10-03T13:11:52", "url": "https://files.pythonhosted.org/packages/ee/4f/aefa5f2583236a492b391c71892bc16ea1c2b53e312af58eee7b9a812de7/mecan4cna-0.27.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "39d2e34aa70f18fcefe65b3850d773c2", "sha256": "edf139a3dd2d9daf0c08b3b2229c5372276ae8f0daa6426b7fdebea607c05f8f" }, "downloads": -1, "filename": "mecan4cna-0.27.tar.gz", "has_sig": false, "md5_digest": "39d2e34aa70f18fcefe65b3850d773c2", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 62585, "upload_time": "2019-10-03T13:11:52", "url": "https://files.pythonhosted.org/packages/ee/4f/aefa5f2583236a492b391c71892bc16ea1c2b53e312af58eee7b9a812de7/mecan4cna-0.27.tar.gz" } ] }