{
    "info": {
        "author": "Stijn De Weirdt",
        "author_email": "stijn.deweirdt@ugent.be",
        "bugtrack_url": null,
        "classifiers": [
            "License :: OSI Approved :: GNU General Public License v2 (GPLv2)"
        ],
        "description": "Description\n===========\n\nmympingpong is a mpi4py based random pair pingpong network stress test.\n\nInstallation\n============\n\nWe recommend using [EasyBuild][eb_url] to automatically install `mympingpong`\nand it's dependencies.\n\nThe required steps involve building a patched mpi4py\nand a parallel enabled h5py.\nInstructions on manual installing these can be found in\nmanual/install_insructions.\n\n\nUsage\n========\n\nAfter successfull installation, simply submit a job that runs\n```\nmympirun mympingpong -f output_dir -i nr_iterations -n nr_tests_per_rank\n```\n\nDependencies\n============\n\n(including but not limited to)\n\n - numpy >= 1.8.2\n - vsc-base >= 1.8.6\n - matplotlib >= 1.3.1\n - h5py >= 2.5.0\n\nExamples\n=======\n\nThe end result of a `mympingponganalysis` is a visual representation of the\npingpong Round Trip Time (RTT) of all the pairs. This can give insight in the architecture and/or topology\n(or any issues with it).\n\n## Example output\n![](/result_images/example.png)\n\neach plot graph up to 5 graphs\n - largest plot: each datapoint is the average pingpong RTT between pairs (x,y), where x and y are the MPI ranks.\n - histogram of all pingpong RTT\n - heatmap of number of pingpongs ran on the (x,y) pair\n - heatmap of the standard deviation in the data from running tests on the (x,y) pair\n - if a mask as been used, a histogram of all pingpong RTT in the mask interval\n\n### Every MPI rank on a unique node\n![](/result_images/stdev.png)\n\nThe result of running pingpong on 128 nodes, with each rank pinned to core 0.\nThe latency graph clearly shows which ranks are located on the same switch.\nThe standard deviation graph show that something fishy is going on with ranks 32-48.\n\n### Every MPI rank on a unique core\n![](/result_images/cores.png)\n\nThe result of running pingpong on 4 nodes with 16 cores per node.\nIn this example the NUMA nodes are visible. Inter node communication is clearly slower then intra node, but only by a factor of 3-5.\nThe histogram shows 3 regions:shared L2 cache, on die and inter-die.\nOn the latency graph the switch is also visible as a greenish shade.\n\n### Oversubscribing\n![](/result_images/oversubscribe.png)\n\nThe result of running 32 ranks per node on 4 nodes with 16 cores per node\n\nUsing PingPong to its fullest potential\n======================\n\nYou should always take care to have enough samples per pair. In other words, \nthe -n parameter should be high enough to ensure every rank has a consistent result. \nA quick way to see if consistent results are achieved, is when the pair samples graph has a deep red color\n\nKnowing that there is a problem might be useful, but you're more than like also going to want to know where the problem is located. \nInformation on what rank is pinned to what core on which node is present in the outputfile, but this data is not plotted with mympingponganalysis. Open it with h5dump or any other HDF5 file reader to get access to this data.\n",
        "description_content_type": null,
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "",
        "keywords": "",
        "license": "GPLv2",
        "maintainer": "",
        "maintainer_email": "",
        "name": "mympingpong",
        "package_url": "https://pypi.org/project/mympingpong/",
        "platform": "",
        "project_url": "https://pypi.org/project/mympingpong/",
        "project_urls": null,
        "release_url": "https://pypi.org/project/mympingpong/0.8.0/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "",
        "version": "0.8.0"
    },
    "last_serial": 3224811,
    "releases": {
        "0.6.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "fcb95f11d5f965c54aa7ffb3a52e75b0",
                    "sha256": "cc9876ea90438752ed117236c376b6c580170a41f478af4a20fe8c84f8cb9f94"
                },
                "downloads": -1,
                "filename": "mympingpong-0.6.1.tar.gz",
                "has_sig": false,
                "md5_digest": "fcb95f11d5f965c54aa7ffb3a52e75b0",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 23500,
                "upload_time": "2015-10-29T13:51:11",
                "url": "https://files.pythonhosted.org/packages/07/71/3e10a66c58211b28d7c8f358bac920826720b9b749b5ace3d7d21eb9f3e4/mympingpong-0.6.1.tar.gz"
            }
        ],
        "0.6.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "0871538864daf893db8e095c52c96f43",
                    "sha256": "2d71b633af068f5fe00f0037c1818d3c3f4b266f1441841ff3943cd24e363241"
                },
                "downloads": -1,
                "filename": "mympingpong-0.6.2.tar.gz",
                "has_sig": false,
                "md5_digest": "0871538864daf893db8e095c52c96f43",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 23515,
                "upload_time": "2015-10-29T16:09:43",
                "url": "https://files.pythonhosted.org/packages/94/df/aa2a84d28d1013ce3e0057d499d2b37aeffabfe9becc84f8c0fa0554d714/mympingpong-0.6.2.tar.gz"
            }
        ],
        "0.7.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "2d83644f749e6a850a9c2c96fdbd3d70",
                    "sha256": "84c9648866ae5c6be0301d0d16ede6b9fa1cae1a7131d7b50a4455b88a5de887"
                },
                "downloads": -1,
                "filename": "mympingpong-0.7.0.tar.gz",
                "has_sig": false,
                "md5_digest": "2d83644f749e6a850a9c2c96fdbd3d70",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 39207,
                "upload_time": "2016-01-24T08:58:36",
                "url": "https://files.pythonhosted.org/packages/ac/54/5186f17a35ad3dc09ec4136e81cb630568986a518112bb959b3a20f52a76/mympingpong-0.7.0.tar.gz"
            }
        ],
        "0.7.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "9be7040c737ec0ce934701aefa20c629",
                    "sha256": "ec26d499fd84eb00107cbd2ec523e7b9b5a0967681f7dfb5631079e5f83f9fcd"
                },
                "downloads": -1,
                "filename": "mympingpong-0.7.1.tar.gz",
                "has_sig": false,
                "md5_digest": "9be7040c737ec0ce934701aefa20c629",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 41667,
                "upload_time": "2016-08-22T12:58:14",
                "url": "https://files.pythonhosted.org/packages/4c/39/22f3cd0d002e3f92963ff39d45d0ac13ccddfa5c5db197d4b3caa3dff5c1/mympingpong-0.7.1.tar.gz"
            }
        ],
        "0.8.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "6283b73f03e7d86e6295c098b2f18dc1",
                    "sha256": "ebc056374a071e49cd13c49c4d5274cf4eee6eb68a7c9033ba2929db27b8bfac"
                },
                "downloads": -1,
                "filename": "mympingpong-0.8.0.tar.gz",
                "has_sig": false,
                "md5_digest": "6283b73f03e7d86e6295c098b2f18dc1",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 42694,
                "upload_time": "2017-10-04T12:10:47",
                "url": "https://files.pythonhosted.org/packages/ac/e8/8301e0b8f5e2a722402b9a273794dff7ce2605d9c1fec8a7237107b3aff0/mympingpong-0.8.0.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "6283b73f03e7d86e6295c098b2f18dc1",
                "sha256": "ebc056374a071e49cd13c49c4d5274cf4eee6eb68a7c9033ba2929db27b8bfac"
            },
            "downloads": -1,
            "filename": "mympingpong-0.8.0.tar.gz",
            "has_sig": false,
            "md5_digest": "6283b73f03e7d86e6295c098b2f18dc1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 42694,
            "upload_time": "2017-10-04T12:10:47",
            "url": "https://files.pythonhosted.org/packages/ac/e8/8301e0b8f5e2a722402b9a273794dff7ce2605d9c1fec8a7237107b3aff0/mympingpong-0.8.0.tar.gz"
        }
    ]
}