{"id":16729897,"url":"https://github.com/dfdx/facedatasets.jl","last_synced_at":"2026-01-03T02:05:50.032Z","repository":{"id":31402971,"uuid":"34966219","full_name":"dfdx/FaceDatasets.jl","owner":"dfdx","description":"Simple(r) access to face-related datasets","archived":false,"fork":false,"pushed_at":"2020-04-29T13:51:15.000Z","size":11351,"stargazers_count":3,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-22T07:16:58.936Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Julia","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dfdx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-05-02T23:02:33.000Z","updated_at":"2021-06-19T20:44:44.000Z","dependencies_parsed_at":"2022-09-09T07:31:28.205Z","dependency_job_id":null,"html_url":"https://github.com/dfdx/FaceDatasets.jl","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfdx%2FFaceDatasets.jl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfdx%2FFaceDatasets.jl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfdx%2FFaceDatasets.jl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfdx%2FFaceDatasets.jl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dfdx","download_url":"https://codeload.github.com/dfdx/FaceDatasets.jl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243763238,"owners_count":20344190,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-12T23:30:31.654Z","updated_at":"2026-01-03T02:05:49.968Z","avatar_url":"https://github.com/dfdx.png","language":"Julia","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FaceDatasets\n\n[![Build Status](https://travis-ci.org/dfdx/FaceDatasets.jl.svg)](https://travis-ci.org/dfdx/FaceDatasets.jl)\n\nPackage for making access to popular face datasets easier.\n\n## General usage\n\n    load_images(\u003cdataset_name\u003e, \u003cdataset_params\u003e...)  # faces\n    load_shapes(\u003cdataset_name\u003e, \u003cdataset_params\u003e...)  # face landmarks\n    load_labels(\u003cdataset_name\u003e, \u003cdataset_params\u003e...)  # provided labels\n\nFor example, to load `CootesDataset`, enter:\n\n    load_images(CootesDataset)\n\nNote, that all methods return iterable objects: for small datasets they are just arrays, for larger iterators are returned instead. You can always materialize them using:\n\n    collect(load_images(...))\n\n\n## Available datasets\n\n### Cootes images\n\n`CootesDataset` contains images from Tim Cootes' work on active appearance models. These images come prepacked, so you can use them for testing.\n\nSupported functions:\n * `load_images(CootesDataset)`\n * `load_shapes(CootesDataset)`\n\n### Cohn-Kanade+ dataset\n\n`CKDataset` contains images from [Cohn-Kanade+ Expression Database](http://www.pitt.edu/~emotion/ck-spread.htm). To install this dataset, download it from [this page](http://www.consortium.ri.cmu.edu/ckagree/) and unpack into a directory of your choice. Example of expected directory layout:\n\n\n```\n$ tree -L 2\n.\n├── cohn-kanade-images\n│   ├── S005\n│   ├── S010\n│   ├── S011\n│   ...\n│   └── S999\n├── Emotion\n│   ├── S005\n│   ├── S010\n│   ├── S011\n│   ...\n│   └── S999\n└── Landmarks\n    ├── S005\n    ├── S010\n    ├── S011\n    ...\n    └── S999\n```\n\nSupported functions:\n * `load_images(CKDataset, datadir, opts...)`\n * `load_shapes(CKDataset, datadir, opts...)`\n * `load_labels(CKDataset, datadir, opts...)`\n\nwhere `datadir` is base dir for CK dataset and labels are numbers representing 6 basic emotions + neutral facial expression.\n\nOptions:\n\n * `start` - image index to start with\n * `count` - number of images to return\n * `indexes` - concrete indexes to return (`start` and `count` are ignored)\n * `resizeratio` - resize image by this value\n\n\n### Cohn-Kanade+ (max only) dataset\n\n`CKMaxDataset` - same as Cohn-Kanade+ dataset, but contains only images with maximally expressed emotion (~500 images). Only `resizeration` option is supported, though.\n\n\nTODO: `KaggleFERDataset`\nTODO: `PutFrontalDataset`","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdfdx%2Ffacedatasets.jl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdfdx%2Ffacedatasets.jl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdfdx%2Ffacedatasets.jl/lists"}