# ShapeY version 2
ShapeY is a benchmark that tests a vision system's shape recognition capacity. ShapeY currently consists of ~68k images of 200 3D objects taken from ShapeNet. Note that this benchmark is not meant to be used as a training dataset, but rather serves to validate that the visual object recogntion / classification under inspection has developed a capacity to perform well on our benchmarking tasks, which are designed to be hard if the system does not understand shape.
## Installing ShapeY
Requirements: Python 3.9, Cuda version 10.2 (prerequisite for cupy)
To install ShapeY, run the following command:
```
pip install ShapeYModular==2.0.5
```
## Step0: Download ShapeY200 dataset
Run `download.sh` to download the dataset. The script automatically unzips the images under `data/ShapeY200/`.
Downloading uses gdown, which is google drive command line tool. If it does not work, please just follow the two links down below to download the ShapeY200 / ShapeY200CR datasets.
ShapeY200:
https://drive.google.com/uc?id=1arDu0c9hYLHVMiB52j_a-e0gVnyQfuQV
ShapeY200CR:
https://drive.google.com/uc?id=1WXpNUVRn6D0F9T3IHruml2DcDCFRsix-
After downloading the two datasets, move each of them to the `data/` directory. For example, all of the images for ShapeY200 should be under `data/ShapeY200/dataset/`.
## Step1: Setup environment variable
Set the environment variable `SHAPEY_IMG_DIR` to the path of the ShapeY200 dataset. For example, if the dataset is under `/data/ShapeY200/dataset/`, then run the following command:
```
export SHAPEY_IMG_DIR=/data/ShapeY200/dataset/
```
Raw data
{
"_id": null,
"home_page": "https://github.com/njw0709/ShapeYV2",
"name": "ShapeYModular",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "tests shape recognition capacity",
"author": "Jong Woo Nam",
"author_email": "namj@usc.edu",
"download_url": "https://files.pythonhosted.org/packages/9a/88/aeffcf9e95cda88f4f2b63044899fa768c49775667a4cc2eb2d4cfc41c86/ShapeYModular-2.0.5.tar.gz",
"platform": null,
"description": "# ShapeY version 2\n\nShapeY is a benchmark that tests a vision system's shape recognition capacity. ShapeY currently consists of ~68k images of 200 3D objects taken from ShapeNet. Note that this benchmark is not meant to be used as a training dataset, but rather serves to validate that the visual object recogntion / classification under inspection has developed a capacity to perform well on our benchmarking tasks, which are designed to be hard if the system does not understand shape.\n\n## Installing ShapeY\nRequirements: Python 3.9, Cuda version 10.2 (prerequisite for cupy)\n\nTo install ShapeY, run the following command:\n```\npip install ShapeYModular==2.0.5\n```\n\n## Step0: Download ShapeY200 dataset\nRun `download.sh` to download the dataset. The script automatically unzips the images under `data/ShapeY200/`.\nDownloading uses gdown, which is google drive command line tool. If it does not work, please just follow the two links down below to download the ShapeY200 / ShapeY200CR datasets.\n\nShapeY200:\nhttps://drive.google.com/uc?id=1arDu0c9hYLHVMiB52j_a-e0gVnyQfuQV\n\nShapeY200CR:\nhttps://drive.google.com/uc?id=1WXpNUVRn6D0F9T3IHruml2DcDCFRsix-\n\nAfter downloading the two datasets, move each of them to the `data/` directory. For example, all of the images for ShapeY200 should be under `data/ShapeY200/dataset/`.\n\n## Step1: Setup environment variable\nSet the environment variable `SHAPEY_IMG_DIR` to the path of the ShapeY200 dataset. For example, if the dataset is under `/data/ShapeY200/dataset/`, then run the following command:\n```\nexport SHAPEY_IMG_DIR=/data/ShapeY200/dataset/\n```\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Benchmark that tests shape recognition",
"version": "2.0.5",
"project_urls": {
"Homepage": "https://github.com/njw0709/ShapeYV2"
},
"split_keywords": [
"tests",
"shape",
"recognition",
"capacity"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9a88aeffcf9e95cda88f4f2b63044899fa768c49775667a4cc2eb2d4cfc41c86",
"md5": "7751ca1784dba4bbce3873042db41b29",
"sha256": "3c529c2594f50839c1947ff9cb54deb84817cf45894be2dfa48fc1bb8c17eb6d"
},
"downloads": -1,
"filename": "ShapeYModular-2.0.5.tar.gz",
"has_sig": false,
"md5_digest": "7751ca1784dba4bbce3873042db41b29",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 371165,
"upload_time": "2023-09-05T19:25:37",
"upload_time_iso_8601": "2023-09-05T19:25:37.995112Z",
"url": "https://files.pythonhosted.org/packages/9a/88/aeffcf9e95cda88f4f2b63044899fa768c49775667a4cc2eb2d4cfc41c86/ShapeYModular-2.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-05 19:25:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "njw0709",
"github_project": "ShapeYV2",
"github_not_found": true,
"lcname": "shapeymodular"
}
JSON
