cmsml


Namecmsml JSON
Version 0.2.7 PyPI version JSON
download
home_pageNone
SummaryPython package of the CMS Machine Learning Group
upload_time2024-11-01 08:42:58
maintainerNone
docs_urlNone
authorNone
requires_python>=3.7
licenseCopyright (c) 2020 - 2023, CMS Machine Learning Group All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
keywords cern cms lhc machine learning tensorflow keras
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <!-- marker-before-logo -->

<p align="center">
  <a href="https://github.com/cms-ml/cmsml">
    <img src="https://raw.githubusercontent.com/cms-ml/cmsml/master/logo.png" />
  </a>
</p>

<!-- marker-after-logo -->

<!-- marker-before-badges -->

<p align="center">
  <a href="https://github.com/cms-ml/cmsml/actions?query=workflow%3A%22Lint+and+test%22">
    <img alt="Lint and test" src="https://github.com/cms-ml/cmsml/workflows/Lint%20and%20test/badge.svg" />
  </a>
  <a href="https://github.com/cms-ml/cmsml/actions?query=workflow%3A%22Deploy+images%22">
    <img alt="Deploy images" src="https://github.com/cms-ml/cmsml/workflows/Deploy%20images/badge.svg" />
  </a>
  <a href="http://cmsml.readthedocs.io">
    <img alt="Documentation status" src="https://readthedocs.org/projects/cmsml/badge/?version=latest" />
  </a>
  <img alt="Python version" src="https://img.shields.io/badge/Python-%E2%89%A53.7-blue" />
  <a href="https://pypi.python.org/pypi/cmsml">
    <img alt="Package version" src="https://img.shields.io/pypi/v/cmsml.svg?style=flat" />
  </a>
  <a href="https://github.com/cms-ml/cmsml/blob/master/LICENSE">
    <img alt="License" src="https://img.shields.io/github/license/cms-ml/cmsml.svg" />
  </a>
</p>

<!-- marker-after-badges -->

<!-- marker-before-header -->

## CMS Machine Learning Group Python package.

The documentation of this Python package is hosted on [readthedocs](http://cmsml.readthedocs.io).

**However**, note that this documentation only covers the API and technical aspects of the package itself.
Usage examples and further techniques for working with machine learning tools in CMS, alongside a collection of useful guidelines can be found in the [general CMS ML group documentation](https://cms-ml.github.io/documentation).

Click [here](https://github.com/cms-ml/cmsml/issues/new?labels=suggestion&template=feature-suggestion.md) to submit a feature suggestion!


<!-- marker-after-header -->

<!-- marker-before-body -->

<!-- marker-before-docker -->

## Docker images

To use the cmsml package via docker, checkout our [DockerHub](https://hub.docker.com/repository/docker/cmsml/cmsml) which contains tags for several Python versions.

| Image                                                        | Python version |    TF Version    | PyTorch Version | GPU support |
| :----------------------------------------------------------- | :------------: | :--------------: | :-------------: | :---------: |
| `cmsml/cmsml:3.7`                                            |      3.7       |      2.11.1      |     1.13.1      |      ✘      |
| `cmsml/cmsml:3.8`                                            |      3.8       |      2.13.1      | latest (~2.3.0) |      ✘      |
| `cmsml/cmsml:3.9`<br>`cmsml/cmsml:3`<br>`cmsml/cmsml:latest` |      3.9       | latest (~2.16.1) | latest (~2.3.0) |      ✘      |
| `cmsml/cmsml:3.10`                                           |      3.10      | latest (~2.16.1) | latest (~2.3.0) |      ✘      |
| `cmsml/cmsml:3.11`                                           |      3.11      | latest (~2.16.1) | latest (~2.3.0) |      ✘      |
| `cmsml/cmsml:3.11-cuda`                                      |      3.11      | latest (~2.16.1) | latest (~2.3.0) |      ✔︎      |

<!-- marker-after-docker -->

<!-- marker-before-testing -->

## Testing

The tests can be triggered with

```shell
pytest -n auto tests
```

and in general, they should be run for Python 3.7 to 3.11.
To run tests in a docker container, do

```shell
# run the tests
./tests/docker.sh cmsml/cmsml

# or interactively by adding a flag "i" to the command
./tests/docker.sh cmsml/cmsml i
> python -m unittest tests
```

In addition, before pushing to the repository, [PEP 8](https://www.python.org/dev/peps/pep-0008) compatibility should be checked with [flake8](https://pypi.org/project/flake8) via

```shell
./tests/lint.sh
```

or using the docker container

```shell
# run the tests
./tests/docker.sh cmsml/cmsml tests/lint.sh
```

<!-- marker-after-testing -->

<!-- marker-before-development -->

- Source hosted at [GitHub](https://github.com/cms-ml/cmsml)
- Report issues, questions, feature requests on [GitHub Issues](https://github.com/cms-ml/cmsml/issues)

<!-- marker-after-development -->

<!-- marker-after-body -->

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "cmsml",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": "CERN, CMS, LHC, machine learning, tensorflow, keras",
    "author": null,
    "author_email": "Marcel Rieger <marcel.rieger@cern.ch>",
    "download_url": "https://files.pythonhosted.org/packages/91/a7/b366f71cb19abe35fe6cc8ef36498e55300b5f881366862a78371f4438f4/cmsml-0.2.7.tar.gz",
    "platform": null,
    "description": "<!-- marker-before-logo -->\n\n<p align=\"center\">\n  <a href=\"https://github.com/cms-ml/cmsml\">\n    <img src=\"https://raw.githubusercontent.com/cms-ml/cmsml/master/logo.png\" />\n  </a>\n</p>\n\n<!-- marker-after-logo -->\n\n<!-- marker-before-badges -->\n\n<p align=\"center\">\n  <a href=\"https://github.com/cms-ml/cmsml/actions?query=workflow%3A%22Lint+and+test%22\">\n    <img alt=\"Lint and test\" src=\"https://github.com/cms-ml/cmsml/workflows/Lint%20and%20test/badge.svg\" />\n  </a>\n  <a href=\"https://github.com/cms-ml/cmsml/actions?query=workflow%3A%22Deploy+images%22\">\n    <img alt=\"Deploy images\" src=\"https://github.com/cms-ml/cmsml/workflows/Deploy%20images/badge.svg\" />\n  </a>\n  <a href=\"http://cmsml.readthedocs.io\">\n    <img alt=\"Documentation status\" src=\"https://readthedocs.org/projects/cmsml/badge/?version=latest\" />\n  </a>\n  <img alt=\"Python version\" src=\"https://img.shields.io/badge/Python-%E2%89%A53.7-blue\" />\n  <a href=\"https://pypi.python.org/pypi/cmsml\">\n    <img alt=\"Package version\" src=\"https://img.shields.io/pypi/v/cmsml.svg?style=flat\" />\n  </a>\n  <a href=\"https://github.com/cms-ml/cmsml/blob/master/LICENSE\">\n    <img alt=\"License\" src=\"https://img.shields.io/github/license/cms-ml/cmsml.svg\" />\n  </a>\n</p>\n\n<!-- marker-after-badges -->\n\n<!-- marker-before-header -->\n\n## CMS Machine Learning Group Python package.\n\nThe documentation of this Python package is hosted on [readthedocs](http://cmsml.readthedocs.io).\n\n**However**, note that this documentation only covers the API and technical aspects of the package itself.\nUsage examples and further techniques for working with machine learning tools in CMS, alongside a collection of useful guidelines can be found in the [general CMS ML group documentation](https://cms-ml.github.io/documentation).\n\nClick [here](https://github.com/cms-ml/cmsml/issues/new?labels=suggestion&template=feature-suggestion.md) to submit a feature suggestion!\n\n\n<!-- marker-after-header -->\n\n<!-- marker-before-body -->\n\n<!-- marker-before-docker -->\n\n## Docker images\n\nTo use the cmsml package via docker, checkout our [DockerHub](https://hub.docker.com/repository/docker/cmsml/cmsml) which contains tags for several Python versions.\n\n| Image                                                        | Python version |    TF Version    | PyTorch Version | GPU support |\n| :----------------------------------------------------------- | :------------: | :--------------: | :-------------: | :---------: |\n| `cmsml/cmsml:3.7`                                            |      3.7       |      2.11.1      |     1.13.1      |      \u2718      |\n| `cmsml/cmsml:3.8`                                            |      3.8       |      2.13.1      | latest (~2.3.0) |      \u2718      |\n| `cmsml/cmsml:3.9`<br>`cmsml/cmsml:3`<br>`cmsml/cmsml:latest` |      3.9       | latest (~2.16.1) | latest (~2.3.0) |      \u2718      |\n| `cmsml/cmsml:3.10`                                           |      3.10      | latest (~2.16.1) | latest (~2.3.0) |      \u2718      |\n| `cmsml/cmsml:3.11`                                           |      3.11      | latest (~2.16.1) | latest (~2.3.0) |      \u2718      |\n| `cmsml/cmsml:3.11-cuda`                                      |      3.11      | latest (~2.16.1) | latest (~2.3.0) |      \u2714\ufe0e      |\n\n<!-- marker-after-docker -->\n\n<!-- marker-before-testing -->\n\n## Testing\n\nThe tests can be triggered with\n\n```shell\npytest -n auto tests\n```\n\nand in general, they should be run for Python 3.7 to 3.11.\nTo run tests in a docker container, do\n\n```shell\n# run the tests\n./tests/docker.sh cmsml/cmsml\n\n# or interactively by adding a flag \"i\" to the command\n./tests/docker.sh cmsml/cmsml i\n> python -m unittest tests\n```\n\nIn addition, before pushing to the repository, [PEP 8](https://www.python.org/dev/peps/pep-0008) compatibility should be checked with [flake8](https://pypi.org/project/flake8) via\n\n```shell\n./tests/lint.sh\n```\n\nor using the docker container\n\n```shell\n# run the tests\n./tests/docker.sh cmsml/cmsml tests/lint.sh\n```\n\n<!-- marker-after-testing -->\n\n<!-- marker-before-development -->\n\n- Source hosted at [GitHub](https://github.com/cms-ml/cmsml)\n- Report issues, questions, feature requests on [GitHub Issues](https://github.com/cms-ml/cmsml/issues)\n\n<!-- marker-after-development -->\n\n<!-- marker-after-body -->\n",
    "bugtrack_url": null,
    "license": "Copyright (c) 2020 - 2023, CMS Machine Learning Group All rights reserved.  Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:  * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.  * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.  * Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ",
    "summary": "Python package of the CMS Machine Learning Group",
    "version": "0.2.7",
    "project_urls": null,
    "split_keywords": [
        "cern",
        " cms",
        " lhc",
        " machine learning",
        " tensorflow",
        " keras"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9f8409c3dd9f59ec2af62f158e26503b8936f50593aab8ccdec5605ecca53c89",
                "md5": "7543b3670e5ce71e3bb670bd4fe382df",
                "sha256": "2c1d379533c20fc40c791f4a4680a0f6c4cb1f937a0f8de49c4162622f52f69c"
            },
            "downloads": -1,
            "filename": "cmsml-0.2.7-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "7543b3670e5ce71e3bb670bd4fe382df",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 26197,
            "upload_time": "2024-11-01T08:42:56",
            "upload_time_iso_8601": "2024-11-01T08:42:56.571975Z",
            "url": "https://files.pythonhosted.org/packages/9f/84/09c3dd9f59ec2af62f158e26503b8936f50593aab8ccdec5605ecca53c89/cmsml-0.2.7-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "91a7b366f71cb19abe35fe6cc8ef36498e55300b5f881366862a78371f4438f4",
                "md5": "aee4b3efeb714ef4c8094774911e1334",
                "sha256": "d02d46e46119f4c1f21e476c034e80cc39671bf73766f4ea20087eaec1605b82"
            },
            "downloads": -1,
            "filename": "cmsml-0.2.7.tar.gz",
            "has_sig": false,
            "md5_digest": "aee4b3efeb714ef4c8094774911e1334",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 24078,
            "upload_time": "2024-11-01T08:42:58",
            "upload_time_iso_8601": "2024-11-01T08:42:58.292481Z",
            "url": "https://files.pythonhosted.org/packages/91/a7/b366f71cb19abe35fe6cc8ef36498e55300b5f881366862a78371f4438f4/cmsml-0.2.7.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-01 08:42:58",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "cmsml"
}
        
Elapsed time: 0.38922s