{"id":19198358,"url":"https://github.com/deepvac/syszuxface","last_synced_at":"2026-01-29T20:03:37.635Z","repository":{"id":51363371,"uuid":"277705855","full_name":"DeepVAC/SYSZUXface","owner":"DeepVAC","description":"DeepVAC-FACE test dataset.","archived":false,"fork":false,"pushed_at":"2021-05-13T12:21:14.000Z","size":12694,"stargazers_count":14,"open_issues_count":0,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-10T15:44:23.603Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DeepVAC.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-07-07T03:21:20.000Z","updated_at":"2023-08-14T06:38:43.000Z","dependencies_parsed_at":"2022-09-25T20:07:08.797Z","dependency_job_id":null,"html_url":"https://github.com/DeepVAC/SYSZUXface","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/DeepVAC/SYSZUXface","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepVAC%2FSYSZUXface","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepVAC%2FSYSZUXface/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepVAC%2FSYSZUXface/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepVAC%2FSYSZUXface/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DeepVAC","download_url":"https://codeload.github.com/DeepVAC/SYSZUXface/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepVAC%2FSYSZUXface/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28884012,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-29T19:55:09.949Z","status":"ssl_error","status_checked_at":"2026-01-29T19:55:08.490Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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-11-09T12:21:31.145Z","updated_at":"2026-01-29T20:03:37.620Z","avatar_url":"https://github.com/DeepVAC.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# SYSZUXface\nDeepVAC-face test dataset.\n一个高质量的用于1:N人脸识别的开源人脸测试集。\n\nSYSZUXface具有如下特点：\n\n- 1:N的人脸识别；\n- ds划分为不同的子分支，方便以后的扩展；\n- db划分为不同的子分支，方便灵活组合；\n- 以中国人为主，未来也会兼顾其它人种；\n- 提供原始图片，检测和识别均需用户自定义实现，更贴近产业；\n\ndataset目录中的图片文件使用git lfs维护，克隆该项目前，你需要首先安装git-lfs：\n```bash\n#on Linux\napt install git-lfs\n\n#on macOS\nbrew install git-lfs\n```\n然后：\n```bash\n#克隆该项目\ngit clone https://github.com/DeepVAC/SYSZUXface\n\n#拉取dataset图片\ngit lfs pull\n```\n\n## 使用说明\n定义如下概念：\n- TP: 预测结果大于阈值，且正确；也即已注册db的ds 匹配到了 正确的db；\n- FP: 预测结果大于阈值，且错误；也即没注册db的ds 匹配到了 某个db，或者已注册db的ds匹配到了错误的db；\n- TN: 预测结果小于阈值，且正确；也即没注册db的ds 没有匹配 任何db；\n- FN: 预测结果小于阈值，且错误；也即已注册db的ds 没有匹配 任何db；\n\n定义准确率、精确率、召回率如下：\n- 准确率(accuracy) = (TP+TN)/(TP+FP+TN+FN)\n- 精确率(precision) = TP/(TP+FP)\n- 召回率(recall) = TP/(TP+FN)\n- 漏检率(漏检率) = FN/(TP+FP+TN+FN)\n- 错误率(错误率) = (FP+FN)/(TP+FP+TN+FN)\n\n项目的目录说明如下：\n|  目录   |  说明   |\n|---------|---------|\n|dataset  |数据集   |\n|src     |测试示例代码|\n|dataset/db | 底库图片，包含多个子目录，默认合并使用|\n|dataset/db/famous | 底库图片，ds/famous测试图片对应的底库图片|\n|dataset/db/soccer | 底库图片，ds/soccer测试图片对应的底库图片|\n|dataset/db/allage | 底库图片，底库的干扰项图片|\n|dataset/db/hancheng | 底库图片，底库的干扰项图片|\n|dataset/db/manyi | 底库图片，底库的干扰项图片|\n|dataset/ds | 待测试图片，包含多个子目录 |\n|dataset/ds/famous | 待测试图片，以公众人物为主，对应的底库图片为db/famous |\n|dataset/ds/soccer | 待测试图片，以足球运动员为主，对应的底库图片为db/soccer |\n\n经典的测试步骤如下：\n- 合并dataset/db下的子目录，组成大而全的底库，目前具备4w+的底库图片；\n- 调整自己的人脸检测和识别算法，确保每个每个底库图片都能提取出特征；\n- 使用自定义人脸检测和识别算法，生成适用于自己算法的底库；\n- 使用自定义人脸检测和识别算法，对ds的子目录进行检测、特征提取、底库特征匹配；\n- 计算ds/soccer的准确率、精确率、召回率、漏检率、错误率；\n- 计算ds/famous的准确率、精确率、召回率、漏检率、错误率；\n\n上述数据可以通过deepvac项目lib库的syszux_report模块来简化计算，下面是个示例：\n```python\n#use the FaceReport class\nfrom deepvac import FaceReport\n#total 5 images to test in gemfield dataset\nreport = FaceReport('gemfield',5)\n#add 5 predict records\nreport.add(\"\",\"2\").add(\"gemfield\",\"gemfield\").add(1,1).add(None,None).add(\"1\",\"1\")\n#report.add(None,None)\n#report.add(None,\"1\")\n#report.add(\"1\",None)\n#report.add(\"1\",\"1\")\n#report.add(\"1\",\"2\") #FP\nreport()\n```\n程序会输出markdown格式的报告：\n```bash\n|dataset|total|duration|accuracy|precision|recall|miss|error|\n|--|--|--|--|--|--|--|--|\n|gemfield|5|0.000|0.8|0.75|1.0|0.0|0.2|\n```\n放入项目的md文件中，在web上会显示为：\n|dataset|total|duration|accuracy|precision|recall|miss|error|\n|--|--|--|--|--|--|--|--|\n|gemfield|5|0.000|0.8|0.75|1.0|0.0|0.2|\n\n## 使用许可\n本项目仅限用于纯粹的学术研究，如：\n- 个人学习；\n- 比赛排名；\n- 公开发表且开源其实现的论文；\n\n不得用于任何形式的商业牟利，包括但不限于：\n- 任何形式的商业获利行为；\n- 任何形式的商务机会获取；\n- 任何形式的商业利益交换；\n\n\n## 项目贡献\n我们欢迎各种形式的贡献，包括但不限于：\n- 提交自己的作品/产品在SYSZUXface上的成绩；\n- 发现和Fix项目的bug；\n- 提交高质量的测试集数据；\n\n## RetinaFace项目：\nRetinaFace项目实现了人脸检测，对齐，识别（包含制作底库），打印report的端到端流程，可以作为参考。\n具体情况请参考[RetinaFace](https://github.com/DeepVAC/RetinaFace)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeepvac%2Fsyszuxface","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeepvac%2Fsyszuxface","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeepvac%2Fsyszuxface/lists"}