[{"_1":2,"_199":-5,"_200":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_174":175},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_89":90,"_111":112,"_163":-5,"_164":11,"_165":21,"_166":11,"_167":-5,"_168":11,"_169":-5,"_170":171,"_172":113,"_173":-7},"canonicalUrl","https://hub.docker.com/r/idinteraction/analysis/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","idinteraction","reponame","analysis","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_58":35,"_32":33,"_59":60,"_61":44,"_62":63,"_64":63,"_65":66,"_67":-5,"_68":69,"_70":71,"_72":11,"_73":33,"_74":75,"_80":21,"_81":82,"_86":33,"_87":88},"categories",[],"content_types",[44],"image","date_registered","2016-02-11T16:42:22.286289Z","description","Packaged scripts for analysis of object tracked data.","is_private","last_updated","2017-07-25T13:31:20.890878Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[56,57],"application/vnd.docker.container.image.v1+json","application/vnd.docker.distribution.manifest.v1+prettyjws","name","pull_count",1186,"repository_type","star_count",1,"status","status_description","active","source","collaborator_count",0,"full_description","# IDInteraction Processing Pipelines\n\n*Pipelines for converting video files and object tracking for automated behavioural coding.*\n\n## Prerequisites\n\nThe only software needed to run these pipelines is [Docker][docker]. Please see the [installation instructions for your platform][dockerdocs] to get started.\n\nTo build these pipelines you will also need:\n* make\n* CMake\n* OpenCV 2.4\n\nYou should use the pre-built docker images, described below, if you possibly can.\n\n## Getting the Docker images\n\nAll of our Docker images are available from the [Docker Hub][dockerhub].\n\nTo get the latest version of the [video processing image][videoimage] run:\n\n```shell\n$ docker pull idinteraction/video\n```\n\nImages are tagged every so often to denote a stable, production quality release. A specific tagged image can be pulled like so:\n\n```shell\n$ docker pull idinteraction/:\n```\n\n## Running the pipelines\n\nThe easiest way of running these pipelines is to use the [tracking tools scripts][tools]. These scripts wrap the complexities of the individual pipelines into simple command-line tools.\n\nInstructions for running the docker images directly, in Linux, are below. There may be platform specific differences that are not taken into account.\n\n### Video processing\n\n*Process the video streams of the participants in our experiments in preparation for input to the object tracking pipeline.*\n\nThe raw video streams are quartered, showing the participants from three directions and the TV they are watching in one frame. This pipeline takes a set of raw experiment videos and splits them into separate streams for the front, side and back view of each participant.\n\nThe directory holding the raw video streams and the directory to which the processed video streams will be saved must be specified when running the docker image. It is advisable to mount the input directory as 'read-only'.\n\nThe following command will run the video processing pipeline on any videos it finds in the input directory (edit the parts in `` to suit your set up):\n\n```shell\n$ docker run -it --rm --name= \\\n -v :/idinteraction/in:ro \\\n -v :/idinteraction/out \\\n idinteraction/video\n```\n\n### Object tracking\n\n*Collect metadata about the video streams to be processed and then perform object tracking.*\n\nTo configure video starting position and object bounding boxes, use:\n\n```shell\n$ docker run -it --rm --name= \\\n -v :/idinteraction/videos:ro \\\n -v :/idinteraction/output \\\n -v /tmp/.X11-unix:/tmp/.X11-unix \\\n -e DISPLAY=unix$DISPLAY \\\n idinteraction/object-tracking init\n```\n\nTo perform object tracking only, use:\n\n```shell\n$ docker run -it --rm --name= \\\n -v :/idinteraction/videos:ro \\\n -v :/idinteraction/output \\\n idinteraction/object-tracking track\n```\n\nTo create videos with the object tracking bounding boxes drawn in them, to help with validating the object tracking process, use:\n\n```shell\n$ docker run -it --rm --name= \\\n -v :/idinteraction/videos:ro \\\n -v :/idinteraction/output \\\n idinteraction/object-tracking replay\n```\n\nTo perform all steps in one go:\n\n```shell\n$ docker run -it --rm --name= \\\n -v :/idinteraction/videos:ro \\\n -v :/idinteraction/output \\\n -v /tmp/.X11-unix:/tmp/.X11-unix \\\n -e DISPLAY=unix$DISPLAY \\\n idinteraction/object-tracking\n```\n\n## Acknowledgements\n\nThe IDInteraction Processing Pipelines were developed in the IDInteraction project, funded by the Engineering and Physical Sciences Research Council, UK through grant agreement number [EP/M017133/1][gow].\n\n## Licence\n\nCopyright (c) 2015, 2016 The University of Manchester, UK.\n\nLicenced under LGPL version 2.1. See LICENCE for details.\n\n[docker]: https://www.docker.com/\n[dockerdocs]: https://docs.docker.com/\n[dockerhub]: https://hub.docker.com/u/idinteraction/\n[gow]: http://gow.epsrc.ac.uk/NGBOViewGrant.aspx?GrantRef=EP/M017133/1\n[tools]: https://github.com/IDInteraction/tracking-tools\n[videoimage]: https://hub.docker.com/r/idinteraction/video/\n","has_starred","hub_user","immutable_tags_settings",{"_76":11,"_77":78},"enabled","rules",[79],".*","is_automated","permissions",{"_83":21,"_84":11,"_85":11},"read","write","admin","user","storage_size",1173642352,"orgData",{"_91":92,"_93":94,"_95":96,"_97":33,"_98":99,"_100":101,"_102":103,"_104":99,"_105":106,"_107":99,"_108":99,"_109":99,"_110":21},"id","dbd537465cdf44899aebf3c7aee13114","uuid","dbd53746-5cdf-4489-9aeb-f3c7aee13114","type","organization","orgname","full_name","","location","Manchester, UK","company","University of Manchester","profile_url","date_joined","2015-06-30T17:42:30.434543Z","gravatar_url","gravatar_email","badge","is_active","recentTags",[113,152],{"_114":44,"_115":116,"_117":118,"_91":119,"_120":121,"_50":139,"_140":141,"_142":143,"_144":56,"_58":145,"_146":147,"_148":129,"_149":139,"_150":66,"_151":21},"content_type","creator",354993,"full_size",475932822,1982372,"images",[122],{"_123":124,"_125":126,"_127":99,"_128":129,"_130":131,"_132":133,"_134":99,"_135":-5,"_136":137,"_64":66,"_138":-5},"architecture","amd64","digest","sha256:c926d5a17a1146a0dd8f34afaab508a6ec96172434b4db17ef24fefdf311ef04","features","last_pulled","2026-09-29T03:07:21.977129174Z","last_pushed","2016-12-09T10:36:41Z","os","linux","os_features","os_version","size",475932630,"variant","2017-07-25T13:31:20.602152Z","last_updater",1267870,"last_updater_username","mawds","media_type","latest","repository",523503,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_114":44,"_115":116,"_117":153,"_91":154,"_120":155,"_50":161,"_140":116,"_142":33,"_144":57,"_58":162,"_146":147,"_148":158,"_149":161,"_150":66,"_151":21},471809585,1988215,[156],{"_123":124,"_125":157,"_127":99,"_128":158,"_130":159,"_132":99,"_134":99,"_135":-5,"_136":160,"_64":66,"_138":-5},"sha256:6a91ad002cefe60c43a05b57ff875d98f90f7820840473c6ea3cddcbb9033feb","2026-09-29T03:07:21.972692785Z","2016-02-12T11:44:17Z",471809841,"2016-02-12T11:44:16.716281Z","1.0","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":176,"_183":184,"_170":197,"_198":11},{"_40":177,"_42":178,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":179,"_58":35,"_32":33,"_59":60,"_61":44,"_62":63,"_64":63,"_65":66,"_67":-5,"_68":69,"_70":71,"_72":11,"_73":33,"_74":180,"_80":21,"_81":182,"_86":33,"_87":88},[],[44],[56,57],{"_76":11,"_77":181},[79],{"_83":21,"_84":11,"_85":11},"tags",{"_185":186,"_187":-5,"_188":-5,"_189":190},"count",2,"next","previous","results",[191,194],{"_114":44,"_115":116,"_117":118,"_91":119,"_120":192,"_50":139,"_140":141,"_142":143,"_144":56,"_58":145,"_146":147,"_148":129,"_149":139,"_150":66,"_151":21},[193],{"_123":124,"_125":126,"_127":99,"_128":129,"_130":131,"_132":133,"_134":99,"_135":-5,"_136":137,"_64":66,"_138":-5},{"_114":44,"_115":116,"_117":153,"_91":154,"_120":195,"_50":161,"_140":116,"_142":33,"_144":57,"_58":162,"_146":147,"_148":158,"_149":161,"_150":66,"_151":21},[196],{"_123":124,"_125":157,"_127":99,"_128":158,"_130":159,"_132":99,"_134":99,"_135":-5,"_136":160,"_64":66,"_138":-5},[],"canDeleteTags","actionData","errors"]

idinteraction/analysis

Tags for idinteraction/analysis