Axis 3D People Counter User Manual

AXIS3DPeopleCounter

UserManual

AXIS3DPeopleCounter

TableofContents

Solutionoverview...........................................3

AXIS3DPeopleCounter..........................................3

What’sthedifferencebetweenAXISPeopleCounterandAXIS3DPeople

Counter?......................................................3

Howtomountthecamera....................................5

Findthedeviceonthenetwork................................9

Accessthedevice...............................................9

Securepasswords...............................................9

Installtheapplicationonthecamera...............................9

Setup.....................................................11

Howtosetdateandtime.........................................11

Howtosetupauseraccount......................................1 1

Aboutthecountingzone.........................................11

Aboutschedules................................................15

Howtoanonymizepeople........................................15

Howtovalidatethesystem...................................16

Aboutthestatistics.........................................17

ConnectacameratoafolderinAXISStoreDataManager..............17

Howtodownloadstatistics.......................................17

Troubleshooting............................................18

Howtorestarttheapplication.....................................18

Howtogeneratealogreport......................................18

Howtomanageyourlicense......................................18

3DpeoplecounterAPI.......................................19

Commonexamples..............................................19

APIspecication................................................19

2

AXIS3DPeopleCounter

Solutionoverview

Solutionoverview

Anoverviewofthedifferentdevices,applications,andtoolsneededforacompletesystem.

AXIS3DPeopleCounter

AXIS3DPeopleCounterisananalyticapplicationthatcanbeinstalledonanetworkcamera.

Thecounterisembeddedinthecamerawhichmeansyoudonotneedadedicatedcomputertoruntheapplication.AXIS3DPeople
Counterisintendedforretailenvironments,likestoresorshoppingmalls,orotherenvironmentswhereyouwanttocountpeople.

What’sthedifferencebetweenAXISPeopleCounterandAXIS3DPeopleCounter?

Theapplicationshavetwodifferentalgorithmsforcountingpeoplewhichmakesthemsuitablefordifferentenvironments:

•AXISPeopleCounterrecognizesobjectsmovingintheeldofviewandidentiesthemaspeopleduetotheiroverallsize
andmovement.AXISPeopleCounterissuitableformostscenarios,coveringsingleaswellasdoubledoorentrances.

3

AXIS3DPeopleCounter

Solutionoverview

•AXIS3DPeopleCountercalculatesthedepthwithintheeldofviewinordertomeasuretheheightandthesizeofthe
object.AXIS3DPeopleCounterissuitableforcrowdedscenariosandsceneswithchallenginglightconditionslike
strongsunlight,glaresandshadows.

4

AXIS3DPeopleCounter

Howtomountthecamera

Howtomountthecamera

Inadditiontotheinstructionsinthecamera’sInstallationGuide,therearesomeimportantstepstofollowfortheapplicationto
behaveintheexpectedway:

•Thecameramustbemountedstraightabovethepointwherepeoplepass.

•Makesurethecameraisfacingstraightdown,inlinewiththeceiling.

•Makesurethereissufcientwhitelightonsite.

5

AXIS3DPeopleCounter

Howtomountthecamera

•Makesuretherearenomovingobjectsinterferinginthecountingarea.Forexample,donotinstallthecameratoo
closetoadoor.

•Loiteringpeopleorlargeplantsthatswayslightlycouldinterferewiththecounting.

Mountingheightandcoverage

Thetablesshowthewidththatcanbecoveredbyacameraatagivenmountingheight.Thewidthofthecountingareaisdifferentif
peoplecangoinandoutintheleftandrightdirection.

Ceilingheight(cm)

24017283

260203119

280234153

300266188

320297221

340328254

360360288

380385314

400363293

Countingareawidth—notusingleft
andright(cm)

Countingareawidth—usingleftand
right(cm)

6

AXIS3DPeopleCounter

Howtomountthecamera

Ceilingheight(in)

956834

10280

1109261

118105

126

134129100

142142

147

158143116

Countingareawidth—notusingleft
andright(in)

117

152124

Countingareawidth—usingleftand
right(in)

47

75

88

114

Countingareawidthnotusingleftandright.

7

AXIS3DPeopleCounter

Howtomountthecamera

Countingareawidthusingleftandright

8

AXIS3DPeopleCounter

Findthedeviceonthenetwork

Findthedeviceonthenetwork

TondAxisdevicesonthenetworkandassignthemIPaddressesinWindows®,useAXISIPUtilityorAXISDeviceManager.Both
applicationsarefreeandcanbedownloadedfromaxis.com/support.

FormoreinformationabouthowtondandassignIPaddresses,seethedocumentHowtoassignanIPaddressandaccessyour
deviceonthedevicepageataxis.com.

Accessthedevice

1.OpenabrowserandentertheIPaddressorhostnameoftheAxisdevice.

IfyouhaveaMaccomputer(OSX),gotoSafari,clickBonjourandselectthedevicefromthedrop-downlist.Toadd
Bonjourasabrowserbookmark,gotoSafari>Preferences.

IfyoudonotknowtheIPaddress,useAXISIPUtilityorAXISDeviceManagertondthedeviceonthenetwork.

2.Entertheusernameandpassword.Ifyouaccessthedeviceforthersttime,youmustsettherootpassword.See
Setasecurepasswordfortherootaccountonpage9.

3.Theliveviewpageopensinyourbrowser.

Securepasswords

Important

Axisdevicessendtheinitiallysetpasswordincleartextoverthenetwork.Toprotectyourdeviceaftertherstlogin,set
upasecureandencryptedHTTPSconnectionandthenchangethepassword.

Thedevicepasswordistheprimaryprotectionforyourdataandservices.Axisdevicesdonotimposeapasswordpolicyasthey
maybeusedinvarioustypesofinstallations.

Toprotectyourdatawestronglyrecommendthatyou:

•Useapasswordwithatleast8characters,preferablycreatedbyapasswordgenerator.

•Don’texposethepassword.

•Changethepasswordatarecurringinterval,atleastonceayear.

Setasecurepasswordfortherootaccount

Important

Thedefaultadministratorusernameisroot.Ifthepasswordforrootislost,resetthedevicetofactorydefaultsettings.

1.Typeapassword.Followtheinstructionsaboutsecurepasswords.SeeSecurepasswordsonpage9.

2.Retypethepasswordtoconrmthespelling.

3.ClickCreatelogin.Thepasswordhasnowbeencongured.

Installtheapplicationonthecamera

Note

•Thelicenseisonlyvalidforonecamera.Youcannotactivatethelicenseonanothercamerawithoutanewregistrationkey.

•Toinstallapplicationsonthecamerayouneedadministratorrights.

9

AXIS3DPeopleCounter

Findthedeviceonthenetwork

1.Installthecameraonyournetwork..

2.Gotothecamera’swebpageinyourbrowser,seetheUserManualforthecamera.

3.GotoSetup>Applications.

4.Ifthereareotherapplicationsinstalledonthecamera,removethem.

5.Uploadtheapplicationle(.eap)tothecamera.

6.ClickthelinkunderApplications>AXIS3DPeopleCounter>Settings.

7.Activatethelicense.Ifyou’reonline,enterthelicensecode.Theapplicationautomaticallyactivatesthelicense.

8.Calibratethecounter.SeeHowtocalibratethecounteronpage12

Howtoactivatethelicensewhenyou’reofine

Toactivatethelicensewhenyou’reofine,youneedalicensekey.Ifyoudon’thavealicensekeyonthecomputer ,dothefollowing:

1.Gotowww.axis.com/applications

2.GotoLicensekeyregistration.YouneedthelicensecodeandtheAxisdeviceserialnumber.

3.Savethelicensekeyleonthecomputerandselectthelewhentheapplicationasksforit.

Howtoaccesstheapplicationsettings

Toaccesstheapplication’swebpage:

•Inthecamera’swebpage,gotoSetup>Application>AXIS3DPeopleCounterandclicktheAXIS3DPeopleCounter
settingslink.

•Inabrowser,type[deviceIP]/stereo.

10

AXIS3DPeopleCounter

Setup

Setup

Howtosetdateandtime

Thedateandtimesettingsareimportantforyourcameratokeepthecorrecttimeforalongerperiodoftime,andforthestatistics
tobeattributedtothecorrecttime.

Youneedtosetthetimeinthecamera’swebpage,andselectthetimezoneintheapplication.

1.Inthecamera’swebpage,gotoSetup>SystemOptions>Date&Time.

2.Intheapplication,gotoSettings>Generalandselectthecorrecttimezone.

Howtosetupauseraccount

Inthecamerayoucansetupdifferentaccountprivilegessothatunauthorizedpersonnelcanviewstatisticsbutnotchange
anysettingsofthecounter.

1.Tosetupauseraccount,gotothecamera’swebpage.

2.GotoSetup>SystemOptions>Security>Users.

3.Fordetailedinstructionsabouttheuseraccount,gotothecamera’sbuilt-inhelp.

Aboutthecountingzone

Thecountingzoneistheareawherethecounterdetectspeople.

Thecountingzoneisindicatedbyatransparentrectangleinthemiddleoftheimage.Itshouldbealignedwiththedoorthreshold.A
perspectiveboxiscreatedontopofthecountingzonewiththeapproximateheightofaperson.Foreachofthefoursidesofthe
perspectivebox,yousetthecountingdirection.

11

AXIS3DPeopleCounter

Setup

Bluetogreen-Whenapersonmovesfrombluetogreen,itgetscountedassomeonegoingin.Arrowsindicatethedirection.

Greentoblue-Whenapersonmovesfromgreentoblue,itgetscountedassomeonegoingout.

Forapersontobecounted,theymustmovefrombluetogreenorfromgreentoblue.Thefeetmustpassthroughthetransparent
rectangleinthemiddle.

Toensuretheaccuracyofthecounter,youmustcalibrateandsetupAXIS3DPeopleCounterbeforeuse.Thesetupisdone
intwosteps:

•First,youneedtocalibratethecountertobeabletoanalyzetheincomingdata.Youperformtheinitialcalibrationwhen
yourstconnecttotheapplication.SeeHowtocalibratethecounteronpage12.

•Second,youmustadjustthecountingzonetotthescene.Youdothisinthesettingspage.SeeHowtosetupthe
counteronpage14.

Howtocalibratethecounter

Duringcalibration,youmustusethefourpapermarkersincludedwiththecamera.Eachmarkerisunique.

Themarkersareavailablehere.Ifyouprintthemyourself,usepapersizeA3/1 1x17in(ledger/tabloid).Makesurethemarkerdoesn’t
llthepage,astheremustbeawidewhitemarginonallsidesforthecalibrationtowork.

Ifthereareanyapplicationsrunningonthecamera,theyarepausedduringthecalibration.

1.Placeonemarkerineachcorneroftheareavisiblethroughthecamera.Itdoesn’tmatterwhichmarkeryouplacewhere.

Important

•Eachmarkerisunique.Makesuretousedifferentmarkersineachcorner.

•Themarkersmustbevisibletothecamerathroughoutthecalibrationprocess.

•Ifyouneedtofastenthemarkerstotheoor,usetransparentadhesive.Ifyouusecoloredadhesiveitcaninterfere

withthecalibrationprocess.

12

AXIS3DPeopleCounter

Setup

2.Intheapplication,yougettotheinitialcalibrationaftertheregistrationpage.Ifyouwanttorecalibratethecounter,

3.ClickCalibrate.Thefollowinghappens:

gotoMaintenance>Calibration.

-Theapplicationgathersdata.

-Theapplicationprocessesthedata.Thisusuallytakes1to5minutes.

-Ifthecalibrationissuccessful,
amarker,itmeansthecalibrationfailedbecausethemarkersareplacedtooclosetogether.Youneedto
movethemarkersandcalibrateagain.

4.Whenthecalibrationisdone,clickGotoliveview.

Reasonsforafailedcalibration:

•themarkersareplacedtooclosetogether

•oneormoremarkersareobscured

•thereareduplicatemarkers

isshownontopofeachmarkerintheimage.Ifisshownontopof

Exampleofachallengingcalibration,wherethetwolowermarkersareplacedtooclosetogether.

13

AXIS3DPeopleCounter

Setup

Asolutiontothechallengingcalibrationistoplaceonemarkerinthecenter.

Howtosetupthecounter

1.Measurethecamera’smountingheight.Thisisthedistancefromtheoortothebottomofthecamera’slens.

SeeHowtomountthecameraonpage5.

2.Intheapplication’swebpage,gotoSettings>General.

3.IntheNameeld,typethenameofthecameraorlocation.

Thiscanbeforexample“Axis_Main_entrance_T_building”.Allcamerasneedtohaveuniquenames.

4.Enterthecamera’smountingheightintheMountingheight(cm)eld.

5.ClickSubmit.

6.GotoSettings>Countingarea.

7.SetTopdirection,Bottomdirection,Rightdirection,andLeftdirectiontoIn,Out,orNone,dependingonthedirectionof
thepeoplepassingbyinliveview .WhenyouselectOut,thatsideturnsblue,andwhenyouselectIn,thatsideturns
greenandisalsoindicatedwithanarrow .

Note

Thecamera’smountingheightaffectsboththewidthadjustmentandthealignmentofthecountingarea.

8.AlignthecountingareawiththedoorthresholdwiththeCountingareaoffsetslider.

9.Toadjustthewidthofthecountingarea,usetheCountingareawidthslider.

14

AXIS3DPeopleCounter

Setup

Aboutschedules

Therearetwotypesofschedules:automaticandmanual.Theautomaticscheduleturnsofftheapplicationwhenthereisinsufcient
lighting.Thisscheduleisusedbydefault.Withamanualschedule,youcandecideyourselfatwhattimestoturntheapplication
onandoffforeachdayoftheweek.

YoucanupdatetheschedulesettingsunderSettings>Advanced>Schedule.

Howtoanonymizepeople

Note

Thissettingisonlyavailableifyouhaveloggedinasanadministrator.

Ifyouwanttopreventpeoplefrombeingidentiedinlivevieworrecordings,youcanturnontheanonymizefeature.Theanonymize
featureblocksallvideostreamsandimagesfromthecameraandturnsliveviewintoablackimage.

Howtoturnonanonymize

1.GotoAdvanced>Anonymize.

2.ClickAnonymize.

Howtoturnoffanonymize

1.Togobacktonormalmode,gotoAdvanced>Anonymize.

2.ClickResetanonymization.

15

AXIS3DPeopleCounter

Howtovalidatethesystem

Howtovalidatethesystem

Note

Beforeyouvalidatethesystem,makesureyouhavemountedthecameraaccordingtotherecommendations.SeeHow
tomountthecameraonpage5.

Whenyouhaveinstalledandsetupallcamerasinthebuilding,werecommendthatyouvalidatetheaccuracyandne-tunethe
system.Thisislikelytoincreasetheaccuracyoridentifyanyproblemswiththecounters.

Togetanoverview,gotoStatisticsandlookatthecountingdataforacoupleofdaysback.Ifthedifferencebetweennumberof
personsgoinginandoutis<5%it’sagoodrstindicationthatthesystemisconguredcorrectly.

Important

•Thevalidationonlyworksif

-thereisonlyasinglepointofentrytothebuilding,or

-allpointsofentrytothebuildingarecoveredbyacounterandthestatisticsareaggregated,manuallyorwith
thehelpofAXISStoreReporter,acrossallcounters.

16

AXIS3DPeopleCounter

Aboutthestatistics

Aboutthestatistics

Thereareseveralwaystousethestatisticsfromthecounter:

•Intheapplication’swebpage,viewreal-timecountingdatainthebuilt-ingraphs.

•Viewbuilt-ingraphsindayandweekviewfromthestatisticspage.Thedataisupdatedinrealtime.

Dataisavailableonthecameraforupto90daysandupdatedeveryminute.Thedataisstoredinone-minutebins
representingtheinandoutcountsforthatminute.

•Viewgraphsofhistoricaldatadirectlyonthecamera.

•DownloaddatathroughanopenAPI.

•UseAXISStoreDataManager,asoftwarepackagethatactsasacentralpointtostoreandmanagedatacollectedfromall
cameras.SeeConnectacameratoafolderinAXISStoreDataManageronpage17.

•UseAXISStoreReporter ,astatisticalweb-basedsolution,formanagingandmonitoringhistoricaldata.

•Downloadstatisticstoyourcomputer,seeHowtodownloadstatisticsonpage17.

ConnectacameratoafolderinAXISStoreDataManager

Toperformthistask,theapplicationmustbeinstalledonthecamera.

1.InAXISStoreDataManager,gotoSourcesandgettheFolderconnectionidentierandtheFolderconnectionpassword
forthefolderyouwanttoconnectto.

2.Inthecamera’swebpage,gotoSetup>Application>AXIS3DPeopleCounterandclickthelink.

3.Intheapplication’swebpage,gotoSettings>Reporting.

4.Toenablepushingdatatoaserver,selectEnabled.

5.EnterthewebaddressforAXISStoreDataManager,forexample
https://[systemintegrator1].asdm.axis.com/datamanagerwhere[systemintegrator1]is
replacedbyauniquename.

6.EntertheFolderconnectionidentierandFolderconnectionpassword.

7.ClickSubmit.

Howtodownloadstatistics

1.GotoStatistics>Downloadstatistics.

2.SelecttheFileformat.

3.SelectTimeinterval.

4.SelectTimeperiod.

5.Selectstartdateandenddateinthecalendars.

6.SelectRetrievalmethod.

7.ClickExport.Thebrowsersavestheleinthedefaultdownloadfolder.

Ifyouwanttodownloadallavailabledata,clickDownloadallnexttotheleformat.

17

AXIS3DPeopleCounter

Troubleshooting

Troubleshooting

Ifyoucan’tndwhatyou’relookingforhere,trythetroubleshootingsectionataxis.com/support.

IssueAction

Thesoftwaredoesnotcount.Makesuretheinstructionsforhowtomountthecamerahas

Istillcannotgetthesoftwaretocount.Ifyouhavefollowedtheadviceaboveandstillcannotgetthe

ThesoftwarepromptsmewithawarningsayingthattheFPS
islow.

Howtorestarttheapplication

Ifthecountingisinaccurateorthewebinterfaceunusuallyslow,youcantryrestartingtherunningservicesorrestartthecamera.

beenfollowed,seeHowtomountthecameraonpage5.

softwaretowork,contactyourAxisreseller.

1.Makesurenootherapplicationsrunonthecameraatthe
sametime.

2.Makesurethereisonlyonevideostreamfromthecamera
runningatatime.

GotoMaintenance>Restart.

Howtogeneratealogreport

Ifyouhaveanytroublewithyourcamerayoucangeneratealogreport.

1.GotoMaintenance>Logs.

2.ClickShowlogs.

3.Thelogreportopensinanewtabinthebrowser.

Howtomanageyourlicense

GotoMaintenance>Registration.

•Toregisteralicense,clickontheRegistrationpage.

18

AXIS3DPeopleCounter

3DpeoplecounterAPI

3DpeoplecounterAPI

Commonexamples

Example

Openallstatisticsthatarestoredinthecamerawithaoneminuteresolution,usingabrowser.

Request(CSV)

http://<servername>/stereo/people-counter/export.csv?export-method=on&date=YYYYMMDD&resolution=60&method=open

SeeListdownloadstatisticsonpage19formoreinformation.

Example

Downloadstatisticsthatoccurredonthe10thofJanuaryof2017.

Request(JSON)

http://<servername>/stereo/people-counter/export.json?resolution=day&date=20170110&method=download

SeeListdownloadstatisticsonpage19formoreinformation.

APIspecication

Requestreal-timedata

ReturnsJSONlewithrealtimecountingdata.

Request

http://<servername>/stereo/people-counter/counts.json

Return

{

"in":0,
"name":"UntitledAXIS3DPeopleCounter",
"out":0,
"serial":"ACCC8E235294",
"timestamp":"20180115121710"

}

Returnvaluedescriptions

ValueDescription

in

name

out

serial

timestamp

Numberofpeoplepassinginuntilnowtoday.

Thenameoftheapplication,chosenbytheclient.

Numberofpeoplepassingoutuntilnow.

TheMacaddressforthecamera.

TimeinthecameraintheformatYYYYMMDDhhmmss.

Listdownloadstatistics

ReturnsstatisticsstoredinthecamerainJSONorplaintextcommaseparatedformat(CSV)

Request(CSV)

http://<servername>/stereo/people-counter/export.csv?resolution=<resolution>&date=<date>&method=<method>

19

AXIS3DPeopleCounter

3DpeoplecounterAPI

Request(JSON)

http://<servername>/stereo/people-counter/export.json?resolution=<resolution>&date=<date>&method=<method>

Requestparameterdescriptions

ParameterDescription

adateoftheformYYYYMMDD

<date>

<resolution>

<method>

adateintervaloftheformYYYYMMDD-YYYYMMDD

commaseparateddatesoftheformYYYYMMDD,[..],YYYYMMDD

all(default)forallavailabledata

minutefordatain1minutebins

hourfordatain1hourbins

dayfordatain1daybins

60fordatain1minutebins

3600fordatain1hourbins

86400fordatain1daybins

selectopentolistthestatisticsinawebbrowser

selectdownloadtodownloadtheJSONorCSVle

Return

ReturnsstatisticsstoredinthecamerainJSONorplaintextcommaseparatedformat(CSV).TherstlineoftheCSVlecontainsa
descriptionofeachelement,andthefollowinglinescontainthecorrespondingdataforthechosentimeintervalandresolution:

IntervalStart,IntervalStart(Unixtime),In,Out

Listframerate

Returnsthecurrentinternalframerate

Request

http://<servername>/stereo/fps.json

Return

{

"fps":realtimefps,
"fps_100":averageFPSforthelast100frames,
"fps_1000":averageFPSforthelast1000frames,
"fps_5":averageFPSforthelast5frames,
"fps_50":averageFPSforthelast50frames,
"frames":framecounter.

}

I/Ointerface

GetthelatestI/Osignalsasfalseortrue.

Request

http://<servername>/stereo/io.json

Return

"True"or"False"

20

AXIS3DPeopleCounter

3DpeoplecounterAPI

Listparameters

Getallparameterscurrentlyset.

Request

http://<servername>/stereo/params.json

Return

AJSONobjectofalltheparameterscurrentlyset.

21

UserManualVer.M10.2
AXIS3DPeopleCounter
©AxisCommunicationsAB,2017-2019

Date:April2019

PartNo.T10098451