norc


Namenorc JSON
Version 0.0.1 PyPI version JSON
download
home_pageNone
SummaryNoise Resilient Hardware Counters in HPC
upload_time2025-08-09 13:24:11
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseNone
keywords hardware counter noise hpc
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # NORC Analysis Components

**NORC** is a Python toolkit for measuring and analyzing the **noise resilience** of hardware counters in High-Performance Computing (HPC) systems.  
It provides both command-line utilities and a GUI for automated performance measurements, statistical analysis, visualization, and ranking of metrics.

---
## Installation

Clone the repository and install locally:

```bash
git clone https://github.com/tuda-parallel/NORC.git
cd NORC/analysis
pip install .
```

## Analyzing Results

NORC offers two types of analysis tools:
- **CLI Tools** – `norc_analyze`, [`norc_plot`](doc/plot.md), and [`norc_rank`](doc/rank.md)  
- **GUI Tool** – `norc_gui`

### NORC CLI
All CLI tools accept an **experiment directory** as input.  
`norc_plot` and `norc_rank` must be run **after** `norc_analyze` has processed the experiment.

Example workflow:
```bash
norc_analyze /path/to/experiment     # Perform analysis
norc_plot /path/to/experiment        # Generate plots
norc_rank /path/to/experiment        # Rank metrics
```
### NORC GUI
The GUI (`norc_gui`) requires no parameters.
After launch:
1. Use the status bar to select the root directory of an experiment.
2. If the experiment has not been analyzed, NORC will process it automatically.

## tdlr;
After installation, the following commands are available
```bash
pip install .
norc_gui # Launches the GUI
norc_analyze /path/to/experiment     # Analyze results
norc_plot /path/to/experiment        # Generate plots (requires analyze)
norc_rank /path/to/experiment        # Rank metrics (requires analyze)
```



            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "norc",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "Lukas Fuchs <lukas.fuchs@stud.tu-darmstadt.de>, Ahmad Tarraf <ahmad.tarraf@tu-darmstadt.de>, Alexander Gei\u00df <alexander.geiss1@tu-darmstadt.de>",
    "keywords": "hardware counter, noise, HPC",
    "author": null,
    "author_email": "Lukas Fuchs <lukas.fuchs@stud.tu-darmstadt.de>, Ahmad Tarraf <ahmad.tarraf@tu-darmstadt.de>, Alexander Gei\u00df <alexander.geiss1@tu-darmstadt.de>",
    "download_url": "https://files.pythonhosted.org/packages/50/0b/9252f197e5e2d3b7a9741b6de5f467a21f307acb879758b4d252f81d2874/norc-0.0.1.tar.gz",
    "platform": null,
    "description": "# NORC Analysis Components\n\n**NORC** is a Python toolkit for measuring and analyzing the **noise resilience** of hardware counters in High-Performance Computing (HPC) systems.  \nIt provides both command-line utilities and a GUI for automated performance measurements, statistical analysis, visualization, and ranking of metrics.\n\n---\n## Installation\n\nClone the repository and install locally:\n\n```bash\ngit clone https://github.com/tuda-parallel/NORC.git\ncd NORC/analysis\npip install .\n```\n\n## Analyzing Results\n\nNORC offers two types of analysis tools:\n- **CLI Tools** \u2013 `norc_analyze`, [`norc_plot`](doc/plot.md), and [`norc_rank`](doc/rank.md)  \n- **GUI Tool** \u2013 `norc_gui`\n\n### NORC CLI\nAll CLI tools accept an **experiment directory** as input.  \n`norc_plot` and `norc_rank` must be run **after** `norc_analyze` has processed the experiment.\n\nExample workflow:\n```bash\nnorc_analyze /path/to/experiment     # Perform analysis\nnorc_plot /path/to/experiment        # Generate plots\nnorc_rank /path/to/experiment        # Rank metrics\n```\n### NORC GUI\nThe GUI (`norc_gui`) requires no parameters.\nAfter launch:\n1. Use the status bar to select the root directory of an experiment.\n2. If the experiment has not been analyzed, NORC will process it automatically.\n\n## tdlr;\nAfter installation, the following commands are available\n```bash\npip install .\nnorc_gui # Launches the GUI\nnorc_analyze /path/to/experiment     # Analyze results\nnorc_plot /path/to/experiment        # Generate plots (requires analyze)\nnorc_rank /path/to/experiment        # Rank metrics (requires analyze)\n```\n\n\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Noise Resilient Hardware Counters in HPC",
    "version": "0.0.1",
    "project_urls": {
        "Bug Tracker": "https://github.com/tuda-parallel/NORC/issues",
        "Changelog": "https://github.com/tuda-parallel/NORC/blob/master/CHANGELOG.md",
        "Documentation": "https://github.com/tuda-parallel/NORC/docs",
        "Homepage": "https://github.com/tuda-parallel/NORC",
        "Repository": "https://github.com/tuda-parallel/NORC"
    },
    "split_keywords": [
        "hardware counter",
        " noise",
        " hpc"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "51244db4d89192a4f351693c0b43930e8f038768eb40de022eb8030089dd6372",
                "md5": "f7aad0631f8def67fc228c98f274bf35",
                "sha256": "8b508a5faf595ada64163335893848bb1afb18f190c38d5e901e442babc999ea"
            },
            "downloads": -1,
            "filename": "norc-0.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "f7aad0631f8def67fc228c98f274bf35",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 36061,
            "upload_time": "2025-08-09T13:24:10",
            "upload_time_iso_8601": "2025-08-09T13:24:10.199466Z",
            "url": "https://files.pythonhosted.org/packages/51/24/4db4d89192a4f351693c0b43930e8f038768eb40de022eb8030089dd6372/norc-0.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "500b9252f197e5e2d3b7a9741b6de5f467a21f307acb879758b4d252f81d2874",
                "md5": "6e70b1483cbda26e57fd9b7be35e6030",
                "sha256": "38cf7d0328b4b67d34f2b87a7e0331113acb5f5366b8571014fe0b314494d59d"
            },
            "downloads": -1,
            "filename": "norc-0.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "6e70b1483cbda26e57fd9b7be35e6030",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 28172,
            "upload_time": "2025-08-09T13:24:11",
            "upload_time_iso_8601": "2025-08-09T13:24:11.827971Z",
            "url": "https://files.pythonhosted.org/packages/50/0b/9252f197e5e2d3b7a9741b6de5f467a21f307acb879758b4d252f81d2874/norc-0.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-09 13:24:11",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "tuda-parallel",
    "github_project": "NORC",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "norc"
}
        
Elapsed time: 0.54289s