s3a


Names3a JSON
Version 0.1.4 PyPI version JSON
download
home_pagehttps://gitlab.com/ficsresearch/s3a
SummaryApplication to facilitate semantic labeling of image data
upload_time2020-09-16 17:52:11
maintainer
docs_urlNone
authorNathan Jessurun
requires_python>=3.7.*
licenseMIT
keywords semantic labeling image annotation
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            [![pipeline status](https://gitlab.com/ficsresearch/s3a/badges/development/pipeline.svg)](https://gitlab.com/ficsresearch/s3a/-/commits/development)
[![coverage report](https://gitlab.com/ficsresearch/s3a/badges/development/coverage.svg)](https://gitlab.com/ficsresearch/s3a/-/commits/development)

# Semi-Supervised Semantic Annotator (S3A)

A highly adaptable tool for both visualizing and generating semantic annotations for generic images.

Most software solutions for semantic (pixel-level) labeling are designed for low-resolution (<10MB) images with fewer than 10 components of interest. Violating either constraint (e.g. using a high-res image or annotating ~1000 components) incur detrimental performance impacts. S3A is designed to combat both these deficiencies. With images up to 150 MB and 2000 components, the tool remains interactive. However, since the use case is tailored to multiple small regions of interest within an image, performance lags when editing individual components of larger than ~1000x1000 pixels. However, for simple bounding polygons (i.e. no running of semantic segmentation algorithms), the individual component sizes can be arbitrarily large.

___

A more detailed overview can be found in the project wiki [here](https://gitlab.com/ficsresearch/s3a/-/wikis/docs/user's-guide).

___

## Installation

The easiest method for installing `s3a` is via `pip` after cloning the repository:

```bash
git clone https://gitlab.com/ficsresearch/s3a
pip install -e ./s3a
```

## Running the App
Running the app is as easy as calling `s3a` as a module:
`python -m s3a`

However, if this is the first time you are starting S3A, you will run into the following error message:
```
No author name provided and no default author exists. Exiting.
To start without error, provide an author name explicitly, e.g.
python -m s3a --author=<Author Name>
```
Since every annotation has an associated author, this field must be populated -- and since there is no default author already registered in the app, it cannot make that association. Simply follow the instruction to set a default author:

`python -m s3a --author="username"`

The app will start as expected. As long as the author remains the same, you can start the app in the future without providing an `--author` flag.
## Detailed Feature List

More information about the capabilities of this tool are outlined in the [project wiki](https://gitlab.com/ficsresearch/s3a/-/wikis/home).


## License

This tool is free for personal and commercial use (except the limits imposed by the PyQt5 library). If you publish something based on results obtained through this app, please cite the following papers:

Jessurun, N., Paradis, O., Roberts, A., & Asadizanjani, N. (2020). Component Detection and Evaluation Framework (CDEF): A Semantic Annotation Tool. Microscopy and Microanalysis, 1-5. doi:10.1017/S1431927620018243




            

Raw data

            {
    "_id": null,
    "home_page": "https://gitlab.com/ficsresearch/s3a",
    "name": "s3a",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.7.*",
    "maintainer_email": "",
    "keywords": "semantic,labeling,image,annotation",
    "author": "Nathan Jessurun",
    "author_email": "njessurun@ufl.edu",
    "download_url": "https://files.pythonhosted.org/packages/33/3a/e484e17d202eb2d34d5512b805ee2bdec4747b26def0207cfe0b2608df09/s3a-0.1.4.tar.gz",
    "platform": "",
    "description": "[![pipeline status](https://gitlab.com/ficsresearch/s3a/badges/development/pipeline.svg)](https://gitlab.com/ficsresearch/s3a/-/commits/development)\n[![coverage report](https://gitlab.com/ficsresearch/s3a/badges/development/coverage.svg)](https://gitlab.com/ficsresearch/s3a/-/commits/development)\n\n# Semi-Supervised Semantic Annotator (S3A)\n\nA highly adaptable tool for both visualizing and generating semantic annotations for generic images.\n\nMost software solutions for semantic (pixel-level) labeling are designed for low-resolution (<10MB) images with fewer than 10 components of interest. Violating either constraint (e.g. using a high-res image or annotating ~1000 components) incur detrimental performance impacts. S3A is designed to combat both these deficiencies. With images up to 150 MB and 2000 components, the tool remains interactive. However, since the use case is tailored to multiple small regions of interest within an image, performance lags when editing individual components of larger than ~1000x1000 pixels. However, for simple bounding polygons (i.e. no running of semantic segmentation algorithms), the individual component sizes can be arbitrarily large.\n\n___\n\nA more detailed overview can be found in the project wiki [here](https://gitlab.com/ficsresearch/s3a/-/wikis/docs/user's-guide).\n\n___\n\n## Installation\n\nThe easiest method for installing `s3a` is via `pip` after cloning the repository:\n\n```bash\ngit clone https://gitlab.com/ficsresearch/s3a\npip install -e ./s3a\n```\n\n## Running the App\nRunning the app is as easy as calling `s3a` as a module:\n`python -m s3a`\n\nHowever, if this is the first time you are starting S3A, you will run into the following error message:\n```\nNo author name provided and no default author exists. Exiting.\nTo start without error, provide an author name explicitly, e.g.\npython -m s3a --author=<Author Name>\n```\nSince every annotation has an associated author, this field must be populated -- and since there is no default author already registered in the app, it cannot make that association. Simply follow the instruction to set a default author:\n\n`python -m s3a --author=\"username\"`\n\nThe app will start as expected. As long as the author remains the same, you can start the app in the future without providing an `--author` flag.\n## Detailed Feature List\n\nMore information about the capabilities of this tool are outlined in the [project wiki](https://gitlab.com/ficsresearch/s3a/-/wikis/home).\n\n\n## License\n\nThis tool is free for personal and commercial use (except the limits imposed by the PyQt5 library). If you publish something based on results obtained through this app, please cite the following papers:\n\nJessurun, N., Paradis, O., Roberts, A., & Asadizanjani, N. (2020). Component Detection and Evaluation Framework (CDEF): A Semantic Annotation Tool. Microscopy and Microanalysis, 1-5. doi:10.1017/S1431927620018243\n\n\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Application to facilitate semantic labeling of image data",
    "version": "0.1.4",
    "split_keywords": [
        "semantic",
        "labeling",
        "image",
        "annotation"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "15aca7ef4b90477db1e45d650cca6333",
                "sha256": "ee7ad86da2eeb2ed7095700f53554c5c95a0bcdd01ae0a3709efa1caad0ee427"
            },
            "downloads": -1,
            "filename": "s3a-0.1.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "15aca7ef4b90477db1e45d650cca6333",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7.*",
            "size": 172486,
            "upload_time": "2020-09-16T17:52:09",
            "upload_time_iso_8601": "2020-09-16T17:52:09.983188Z",
            "url": "https://files.pythonhosted.org/packages/08/78/e190a60f13d0b16c85e2d1dd811bdab4ce5483bd7f8d18ee70114985cb8b/s3a-0.1.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "05e188289fabde07753b8800e8f2ee5d",
                "sha256": "321e188a1485c68444253aaa42ca876023e3368f557abd9ccf3b7db37379df40"
            },
            "downloads": -1,
            "filename": "s3a-0.1.4.tar.gz",
            "has_sig": false,
            "md5_digest": "05e188289fabde07753b8800e8f2ee5d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7.*",
            "size": 132414,
            "upload_time": "2020-09-16T17:52:11",
            "upload_time_iso_8601": "2020-09-16T17:52:11.349798Z",
            "url": "https://files.pythonhosted.org/packages/33/3a/e484e17d202eb2d34d5512b805ee2bdec4747b26def0207cfe0b2608df09/s3a-0.1.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2020-09-16 17:52:11",
    "github": false,
    "gitlab": true,
    "bitbucket": false,
    "gitlab_user": null,
    "gitlab_project": "ficsresearch",
    "lcname": "s3a"
}
        
Elapsed time: 0.15758s