ngautonml-image


Namengautonml-image JSON
Version 0.4.1b1 PyPI version JSON
download
home_page
Summarya plugin that installs image processing tools for ngAutonML
upload_time2024-01-04 16:49:56
maintainer
docs_urlNone
author
requires_python
license
keywords machine learning image processing
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # ngAutonML

Image-specific docs coming soon to a repo near you!

## ngAutonML

The **ngAutonML** project is an Automated Machine Learning solution intended to make it much easier to find good solutions to common machine learning problems, or to aid in prototyping a more complex solution. It aims to be simple to use for the bulk of machine learning problems, but maintains a high level of customizability for those situations that require more specific setups by more experiences machine learning professionals.

This project is the result of research performed as part of the [D3M](https://datadrivendiscovery.org) project run by DARPA. It is a reimplementation of many concepts used in that project, and is currently under heavy development.

## Installation

At this time, the only installation available is via cloning the repository on GitLab:
```
git clone git@gitlab.com:autonlab/ngautonml.git
```
As the project leaves Alpha stage, a Pypi package will be posted for easy installation.

It is recommended to create a virtual environment to run ngautonml.  To do so with conda, run:
```
conda create -n env-name python=3.9
conda activate env-name
```

ngAutonML is designed to run on Python 3.9 and above.

A ```requirements.txt``` file is provided to install necessary libraries. Use:

```
pip install -r requirements.txt
```
In addition, if you are a developer, install ```requirements-dev.txt```, which contains linters that code must be fully compliant with:
```
pip install -r requirements-dev.txt
```

## Usage

To use the current ngAutonML, you need a Problem Definition(explained later) to activate with:

```
python picard.py wrangle -d <path to problem definition>
```

## Problem Definitions

The problem definition file is a JSON file that describes the dataset being used, and how it should be handled, in a simplified level that requires only minimal knowledge of machine learning. Examples can be found in the ```examples/problem_definition``` directory under the project, but in brief the important aspects are the following fields:

- metrics: This field defines the scoring metric(s) that the Auto ML will use to determine fitness. At this time there is little documentation on what all the metrics require for parameters.
- dataset: This field is required, with the two major subfields being the ```train_path``` pointing to the training dataset(in csv format) and the ```target``` field defining which column will be predicted. For those datasets that have a test to run, the ```test_path``` is also provided here
- problem_type: This uses the subfields of ```data_type``` to tell the type of dataset, and the ```task``` to determine how the dataset will be handled, such as a classification or forecasting problem. The full documentation will have a set of possible tasks and how to identify which problem your data falls into.

## Support

Currently all issues should be generated via the GitLab Issue Tracker.

## Roadmap

In Development:
- Support for external models such as Docker Containers or LLM services
- Code generation for insertion into your own projects or for low-level customization
- API support

## Contributing

If forking and wanting to contribute, please ensure PEP8 Compliance. The current project uses flake8, mypy, and pylint for code compliance, with the exception of setting the maximum line length to 100 characters.

## Authors and acknowledgment

The CMU AutonML Development Team:

Piggy Yarroll (programmer/architect) \
Andrew Williams (programmer) \
Merritt Kowaleski (programmer) \
Mujing Wang (programmer) \
Carter Weaver (programmer) \
Jeishi Chen (data scientist)

## License

This project is currently licensed under the Apache 2.0 license.

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "ngautonml-image",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "machine learning,image processing",
    "author": "",
    "author_email": "\"L.H. Piggy Yarroll\" <piggy@cmu.edu>, Merritt Kowaleski <merrittk@cmu.edu>, Andrew Williams <awillia2@andrew.cmu.edu>, Jieshi Chen <jieshic@andrew.cmu.edu>",
    "download_url": "https://files.pythonhosted.org/packages/24/bc/9100fb519b2d12401afdc6ba09c50dbd02b5ae60067307117eb7ba19eb7f/ngautonml_image-0.4.1b1.tar.gz",
    "platform": null,
    "description": "# ngAutonML\n\nImage-specific docs coming soon to a repo near you!\n\n## ngAutonML\n\nThe **ngAutonML** project is an Automated Machine Learning solution intended to make it much easier to find good solutions to common machine learning problems, or to aid in prototyping a more complex solution. It aims to be simple to use for the bulk of machine learning problems, but maintains a high level of customizability for those situations that require more specific setups by more experiences machine learning professionals.\n\nThis project is the result of research performed as part of the [D3M](https://datadrivendiscovery.org) project run by DARPA. It is a reimplementation of many concepts used in that project, and is currently under heavy development.\n\n## Installation\n\nAt this time, the only installation available is via cloning the repository on GitLab:\n```\ngit clone git@gitlab.com:autonlab/ngautonml.git\n```\nAs the project leaves Alpha stage, a Pypi package will be posted for easy installation.\n\nIt is recommended to create a virtual environment to run ngautonml.  To do so with conda, run:\n```\nconda create -n env-name python=3.9\nconda activate env-name\n```\n\nngAutonML is designed to run on Python 3.9 and above.\n\nA ```requirements.txt``` file is provided to install necessary libraries. Use:\n\n```\npip install -r requirements.txt\n```\nIn addition, if you are a developer, install ```requirements-dev.txt```, which contains linters that code must be fully compliant with:\n```\npip install -r requirements-dev.txt\n```\n\n## Usage\n\nTo use the current ngAutonML, you need a Problem Definition(explained later) to activate with:\n\n```\npython picard.py wrangle -d <path to problem definition>\n```\n\n## Problem Definitions\n\nThe problem definition file is a JSON file that describes the dataset being used, and how it should be handled, in a simplified level that requires only minimal knowledge of machine learning. Examples can be found in the ```examples/problem_definition``` directory under the project, but in brief the important aspects are the following fields:\n\n- metrics: This field defines the scoring metric(s) that the Auto ML will use to determine fitness. At this time there is little documentation on what all the metrics require for parameters.\n- dataset: This field is required, with the two major subfields being the ```train_path``` pointing to the training dataset(in csv format) and the ```target``` field defining which column will be predicted. For those datasets that have a test to run, the ```test_path``` is also provided here\n- problem_type: This uses the subfields of ```data_type``` to tell the type of dataset, and the ```task``` to determine how the dataset will be handled, such as a classification or forecasting problem. The full documentation will have a set of possible tasks and how to identify which problem your data falls into.\n\n## Support\n\nCurrently all issues should be generated via the GitLab Issue Tracker.\n\n## Roadmap\n\nIn Development:\n- Support for external models such as Docker Containers or LLM services\n- Code generation for insertion into your own projects or for low-level customization\n- API support\n\n## Contributing\n\nIf forking and wanting to contribute, please ensure PEP8 Compliance. The current project uses flake8, mypy, and pylint for code compliance, with the exception of setting the maximum line length to 100 characters.\n\n## Authors and acknowledgment\n\nThe CMU AutonML Development Team:\n\nPiggy Yarroll (programmer/architect) \\\nAndrew Williams (programmer) \\\nMerritt Kowaleski (programmer) \\\nMujing Wang (programmer) \\\nCarter Weaver (programmer) \\\nJeishi Chen (data scientist)\n\n## License\n\nThis project is currently licensed under the Apache 2.0 license.\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "a plugin that installs image processing tools for ngAutonML",
    "version": "0.4.1b1",
    "project_urls": null,
    "split_keywords": [
        "machine learning",
        "image processing"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "75bc47b29b3a1a6b86bc2d5935ca9bba4b2fea6b81eac54130993968373b325c",
                "md5": "17a0b472c95d2d3965346282c81efc0e",
                "sha256": "fe3d5ddbcf36044a4a7c53d718ab3234f25650320957dad99d89e06f5b1d206e"
            },
            "downloads": -1,
            "filename": "ngautonml_image-0.4.1b1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "17a0b472c95d2d3965346282c81efc0e",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 13076,
            "upload_time": "2024-01-04T16:49:55",
            "upload_time_iso_8601": "2024-01-04T16:49:55.776126Z",
            "url": "https://files.pythonhosted.org/packages/75/bc/47b29b3a1a6b86bc2d5935ca9bba4b2fea6b81eac54130993968373b325c/ngautonml_image-0.4.1b1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "24bc9100fb519b2d12401afdc6ba09c50dbd02b5ae60067307117eb7ba19eb7f",
                "md5": "508d762f5fe685aa57f91c07429324f3",
                "sha256": "7749aca172648808aa73a6eef7a3d55595a5c5364212859df1bc8e625e15ff30"
            },
            "downloads": -1,
            "filename": "ngautonml_image-0.4.1b1.tar.gz",
            "has_sig": false,
            "md5_digest": "508d762f5fe685aa57f91c07429324f3",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 11014,
            "upload_time": "2024-01-04T16:49:56",
            "upload_time_iso_8601": "2024-01-04T16:49:56.895785Z",
            "url": "https://files.pythonhosted.org/packages/24/bc/9100fb519b2d12401afdc6ba09c50dbd02b5ae60067307117eb7ba19eb7f/ngautonml_image-0.4.1b1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-01-04 16:49:56",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "ngautonml-image"
}
        
Elapsed time: 0.15548s