{"id":16837817,"url":"https://github.com/zhreshold/mxnet-ssd.cpp","last_synced_at":"2025-10-16T15:34:45.319Z","repository":{"id":67409549,"uuid":"69612029","full_name":"zhreshold/mxnet-ssd.cpp","owner":"zhreshold","description":"C++ object detection module for mxnet-ssd","archived":false,"fork":false,"pushed_at":"2017-03-21T22:11:48.000Z","size":7206,"stargazers_count":97,"open_issues_count":16,"forks_count":47,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-02-27T18:06:37.386Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zhreshold.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,"governance":null}},"created_at":"2016-09-29T22:11:18.000Z","updated_at":"2024-09-28T02:47:49.000Z","dependencies_parsed_at":"2023-06-11T01:15:12.056Z","dependency_job_id":null,"html_url":"https://github.com/zhreshold/mxnet-ssd.cpp","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhreshold%2Fmxnet-ssd.cpp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhreshold%2Fmxnet-ssd.cpp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhreshold%2Fmxnet-ssd.cpp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhreshold%2Fmxnet-ssd.cpp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zhreshold","download_url":"https://codeload.github.com/zhreshold/mxnet-ssd.cpp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243842077,"owners_count":20356602,"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-13T12:18:55.016Z","updated_at":"2025-10-16T15:34:45.260Z","avatar_url":"https://github.com/zhreshold.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mxnet-ssd.cpp\nC++ object detection module for [mxnet-ssd](https://github.com/zhreshold/mxnet-ssd).\n\nNote that python detection module is already included in mxnet-ssd.\nThe goal of this repository is to create a test end for mxnet-ssd with no external\ndependency.\n\n![demo](https://cloud.githubusercontent.com/assets/3307514/19162698/900ec9ec-8bbe-11e6-9f24-505906c96371.jpg)\n![demo1](https://cloud.githubusercontent.com/assets/3307514/19162697/8f14062e-8bbe-11e6-8f5f-1a4cefb6b428.jpg)\n\n### Installation\n\n#### Ubuntu/Debian\n* Install prerequisites, via `sudo apt-get install cmake git build-essentials`\nand make sure your c++ compiler support C++11 (g++4.8 or above): `g++ --version`\n* Clone this repo recursively:\n`git clone --recursive https://github.com/zhreshold/mxnet-ssd.cpp`\n* Build all using script:\n```\ncd $REPO_ROOT/build\nbash ./install.sh\n```\n\n#### Windows\n* Install prerequisite: \n    - `cmake` and `git`(git is optional, highly recommended), they both provide installer online. \n    - Install Visual Studio 2015(verified version).\n* Clone this repo:\n```\ngit clone https://github.com/zhreshold/mxnet-ssd.cpp\ngit checkout win\n# or you can download from github as zip file if git was not installed\n# be sure to switch to branch win before download\n```\n* Generate VS solution:\n```\ncd /path/to/repo/build\n./create_sln_vs2015.bat\n# the solution will be created in build/vc14/\n# open this solution and build, the executable and dlls will be copied to /repo/build if success\n```\n\n#### OSX\nInstallation guide to be added.\n\n### Download the model\nDownload the pretrained [model](https://github.com/zhreshold/mxnet-ssd.cpp/releases/download/v0.1/deploy_ssd_300_voc0712.zip) and unzip to the same folder as the executable.\nBy default it's the `build` directory.\n\nYou can put the model any where you like, as long as you run the program with `--model /path/to/model_prefix`\n\n### Usage\n```\ncd $REPO_ROOT/build\n./ssd ../demo/000001.jpg\n# save detection image\n./ssd ../demo/000004.jpg -o out.jpg\n# save detection results to text file\n./ssd ../demo/000002.jpg --save-result result.txt\n```\nFull usage info: `./ssd -h`\n\n```\nUsage: ssd  [-hv] [-o \u003cFILE\u003e] [-m \u003cFILE\u003e] [-e \u003cINT\u003e] [--class-map \u003cFILE\u003e] [--width \u003cINT\u003e] [--height \u003cINT\u003e] [-r \u003cFLOAT\u003e] [-g \u003cFLOAT\u003e] [-b \u003cFLOAT\u003e] [-t \u003cFLOAT\u003e] [--gpu \u003cINT\u003e] [--disp-size \u003cINT\u003e] [--save-result \u003cFILE\u003e] \u003cFILE\u003e\n\n  Required options:\n  \u003cFILE\u003e                    input image\n\n  Optional options:\n  -h, --help                print this help and exit\n  -v, --version             print version and exit\n  -o, --out=FILE            output detection result to image\n  -m, --model=FILE          load model prefix(default: deploy_ssd_300)\n  -e, --epoch=INT           load model epoch(default: 1)\n  --class-map=FILE          load classes from text file\n  --width=INT               resize width(default: 300)\n  --height=INT              resize height(default: 300)\n  -r, --red=FLOAT           red mean pixel value(default: 123)\n  -g, --green=FLOAT         green mean pixel value(default: 117)\n  -b, --blue=FLOAT          blue mean pixel value(default: 104)\n  -t, --thresh=FLOAT        visualize threshold(default: 0.5)\n  --gpu=INT                 gpu id to detect with, default use cpu(default: -1)\n  --disp-size=INT           display size, -1 to disable display(default: 640)\n  --save-result=FILE        save result in text file\n\n\n```\n\n### Credits\n* [CImg](https://github.com/dtschump/CImg)\n* [MXNet](https://github.com/dmlc/mxnet)\n* [zupply](https://github.com/zhreshold/zupply)\n* [OpenBLAS](https://github.com/xianyi/OpenBLAS)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhreshold%2Fmxnet-ssd.cpp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzhreshold%2Fmxnet-ssd.cpp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhreshold%2Fmxnet-ssd.cpp/lists"}