2. Axis
  3. Loitering Guard
Loitering Guard

Axis Loitering Guard User manual

  • Hello! I have read the AXIS Loitering Guard user manual and understand its content. This document describes an application that monitors an area for loitering objects and can be configured with different profiles, include/exclude areas, filters and visual confirmation. I'm ready to answer your questions about the application and its features.
  • What is AXIS Loitering Guard used for?
    Can I use filters to reduce false alarms?
    What is an include area?
    What is an exclude area?
    Can the alarm be used by third-party software?
AXISLoiteringGuard
UserManual
AXISLoiteringGuard
Abouttheapplication
Abouttheapplication
AXISLoiteringGuardmonitorsanareaofinterestandsendsanalarmifpeople,vehicles,orotherobjectsmovearoundinsidethe
areafortoolong.Thisbehaviorisconsideredloitering.ThealarmcanbeusedbyAxisnetworkvideodevices,andbythird-party
software,to,forexample,alertsecuritystafforrecordvideo.
Toreducefalsealarms,uselterstoignoreobjectssuchasswayingfoliageandsmallanimals.
Useprolestocreatemultiplecongurations,forexamplefordaytimeandnighttimeorfordifferentpartsofthescene.Eachprole
hasitsownsettingsandgeneratesitsownalarms.
Requirements
TheapplicationcanbeinstalledonAxisnetworkvideodevicesthatsupportAXISCameraApplicationPlatform.Acompletelistof
compatibledevicesandrmwareversionsisavailableataxis.com/applications
Werecommendthefollowingbrowsers:
•ChromeTM
•Firefox®
Cameramountingrecommendations
Beforeyoustarttousetheapplication,considerthefollowingrecommendations:
•Ifthemonitoredareahassignicantdifferencesinelevation,createmultipleprolesandsetuptheperspectivein
eachprole.SeeHowtoworkwithprolesonpage4.
•Detectionaccuracymaybeaffectedbyweatherconditionssuchasheavyrainorsnow.
•Makesurethatthelightingconditionsarewithintheproduct’sspecication.Useadditionallightingifneeded.
•Makesurethatthecameraisnotsubjecttoexcessivevibrations.Vibrationsmighttriggerfalsealarms.
•EachtimeaPTZpresetpositionchanges,theapplicationneedstorecalibrate.Wedonotrecommendtorunaguard
tourtogetherwithloiteringguard.
•Eachtimethelterschange,theapplicationrecalibrates.Objectsdetectedbeforeyouchangeltersthereforeneed
sometimetoberedetectedbytheapplication.
•Smallanddistantobjectsmightnotbedetected.
•Objectsapproachinginastraightlinetowardsthecameraneedtomovealongerdistancebeforetheyaredetected
comparedtootherobjects.
2
AXISLoiteringGuard
Installtheapplication
Installtheapplication
Note
Toinstallapplicationsontheproductyouneedadministratorrights.
1.Todownloadtheapplication,gotoaxis.com/applications.
2.Logintothecamera’swebpage.
3.GotoSettings>AppsandclickAdd.
4.Uploadtheapplicationle(.eap)tothecamera.
Starttheapplication
1.Logintotheproduct'swebpageandgotoSettings>Apps.
2.Selecttheapplication.
3.Turnontheappwiththetogglebutton.
Stoptheapplication
1.Logintotheproduct'swebpageandgotoSettings>Apps.
2.Selecttheapplication.
3.Turnofftheapplicationwiththetogglebutton.
3
AXISLoiteringGuard
Setuptheapplication
Setuptheapplication
Thisisanoverviewofhowtosetuptheapplication.
1.Logintotheproduct’swebpageasanadministratorandgotoSettings>Apps>AXISLoiteringGuard.
2.SelecttheapplicationandclickOpen.
3.Useprolestocreatemultiplecongurations,forexamplefordaytimeandnighttimeorfordifferentpartsofthescene.
Eachprolehasitsownsettingsandgeneratesitsownalarms.
4.Todenethepartsofthesceneinwhichmovingobjectsshouldbedetected,useincludeandexcludeareas.
5.Setuptheloiteringconditions.
6.Usevisualconrmationtomakesurethatallobjectsthatshouldbedetectedaredetected.
7.Triggeranalarmwiththetestalarmfunction.
8.Iftheapplicationtriggerstoomanyunwantedalarms,useoneormoreofthelters.
1Liveview
2Prolesettings
3Testalarmandvisualconrmation
4
AXISLoiteringGuard
Setuptheapplication
Howtoworkwithproles
Eachproletriggersitsownalarmsandhasitsownsettings,makingitpossibletocreateeventswithdifferentactionsinthecamera
andthird-partysoftware.Forexample,touseonecongurationduringthedayandoneduringthenight,createtwoproleswith
differentsettings.Thencreateoneactionruleforeachproleandusedaytimeandnighttimeschedulesasadditionalconditions.
Whentousemultipleproles:
•tosetupdifferentcongurationsfordayandnight
•tousemultipleincludeareas
•tosetupdifferentcongurationsfordifferentPTZpresetpositions
•whenyouwanttousemultipleincludeareas
•tosetupseveralactionruleswithdifferentloiteringconditions
•ifthecameramonitorsanareawithdifferencesinelevation,proleswithdifferentperspectivesetupscanbeusedtolter
smallobject.Dividetheareaintoregionswithoutsignicantelevationdifferencesandcreateoneproleforeachregion.
Ineachprole,modifytheincludeareatocovertheregionandcalibrateperspectiveintheregioninsteadofinthewhole
image.SeeFiltersmallobjectsinascenewithdepthonpage10.
Howtocreateaprole
1.Gototheapplication’swebpageandclick
2.Tocopythesettingsfromapreviouslycreatedprole,selectaprolefromthelistImportsettingsfrom.
3.Torenametheprole,gotoProlepropertiesandclick
4.TypethenameinthetexteldandclickDone.
Howtodeleteaprole
Note
Ifyoudeleteaprolethatisusedbyanactionruleorbyathird-partysoftware,remembertodeleteoredittheaction
ruleorthird-partysoftwareaswell.
Clickthecrossontheprole’stabordothefollowing:
1.Selecttheprole’stab.
2.GotoProlepropertiesandclick
3.ClickandconrmbyclickingDone.
HowtoconnectaproletoaPTZpresetposition
Note
Eachtimethepresetpositionchanges,theapplicationneedstorecalibrate.
5
AXISLoiteringGuard
Setuptheapplication
Torestrictdetectiontoaspecicpresetposition,youcanconnecttheproletoapresetposition.
1.Gototheapplication’swebpageandselectanexistingprole,orclicktocreateanewprole.
2.TurnonConnectedpresetpositionwiththetogglebutton.
3.Fromthedrop-down-list,selectapresetposition.
Todetectloiteringinallpresetpositions,selectAllpresetpositions.
Addalarmoverlaystovideostreams
Toshowwhattriggeredanalarmintheliveandrecordedvideostream,turnonalarmoverlay.Whenalarmoverlayisturned
on,arectangleisshownaroundobjectsthattriggeralarms.
Important
Thealarmoverlaysareburntintothevideostream.Youcan’tremovethemfromrecordedvideo.
Note
Ifyouuseviewareas,thealarmoverlaysonlyappearintherstviewarea.Thedefaultnameoftherstviewareais
Viewarea1.
1.Gototheapplication’swebpageandselectanexistingprole,orclicktocreateanewprole.
2.TurnonAlarmoverlay.
3.Selectinwhichresolutionalarmoverlaysshouldappear.Youcanonlyselectoneresolutionanditwillbeappliedtoall
proleswithalarmoverlay.
4.ClickNext.
5.Openyourvideomanagementsoftware(VMS)andplacethewindowsside-by-side.
6.Tomakesurethatthealarmoverlaysshowupinthevideostreams,gobacktotheapplication’swebpageandclick
Testalarm.
7.ClickFinish.
Includearea
Theincludeareaistheareainwhichloiteringobjectstriggeralarms.Objectscantriggeralarmsevenifonlyapartoftheobjectis
insidetheincludearea.Theapplicationignoresanyloiteringobjectsoutsidetheincludearea.
Thedefaultincludeareaisarectanglethatcoversthewholeimage.
Usethemousetoreshapeandresizetheareasothatitonlycoversthepartoftheimageinwhichloiteringobjectsshouldbe
detected.Thedefaultrectanglecanbechangedtoapolygonwithupto10corners.
•Toaddanewcorner,clicktheborderoftheincludearea.Dragthecornertothedesiredposition.
•Tomoveacorner,clickanddragthecornertothenewposition.
•Toremoveacorner,right-clickthecorner.
•Tomovetheentireincludearea,placethemousepointerinsidethearea.Whenthepointerchangesshape,dragthe
areatothenewposition.
6
AXISLoiteringGuard
Setuptheapplication
•Toselecttheincludearea,clickinsidetheincludearea,orclick.
•Toresettheincludeareatoitsdefaultsize,click.
Recommendation
Ifthere’sabusyroadorsidewalkclosetotheincludearea,drawtheincludeareasothatobjectsoutsidetheincludeareadon’t
accidentallygetdetected.Thismeansyoushouldavoiddrawingtheincludeareatooclosetothebusyroadorsidewalk.
Excludeareas
Anexcludeareaisanareainsideanincludeareainwhichloiteringobjectsdonottriggeralarms.Useexcludeareasifthereareareas
insidetheincludeareathattriggeralotofunwantedalarms.Assoonastheobjectentersanexcludearea,theapplicationpausesthe
loiteringtimeforthatobject.Whentheobjectreenterstheincludearea,theloiteringtimecontinuestoincrease.
Youcancreateupto3excludeareas.
Usethemousetomove,reshapeandresizetheareasothatitcoversthedesiredpartoftheimage.Thedefaultrectanglecan
bechangedtoapolygonwithupto10corners.
•Toaddanewcorner,clicktheexcludeareaborder.Dragthecornertothedesiredposition.
7
AXISLoiteringGuard
Setuptheapplication
•Tomoveacorner,clickanddragthecornertothenewposition.
•Toremoveacorner,right-clickthecorner.
•Tomovetheexcludearea,placethepointerinsidethearea.Clickanddragtheareatothenewposition.
•Toaddanexcludearea,click
•Toselectanexcludearea,clickintheexcludearea,orclick
•Toremoveanexcludearea,click
Recommendation
Placeexcludeareasinsidetheincludearea.Useexcludeareastocover,forexample,movingtreesorvegetationthattrigger
falsealarms.
8
AXISLoiteringGuard
Setuptheapplication
Aboutloiteringconditions
Loiteringconditionsdenewhenthereisloiteringinthearea.Setthemaximumtimeanobjectisallowedtoloiterbeforeanalarm
triggersandthenchoosebetweenthefollowingconditions:
•Individualmeanstheapplicationtracksthetimeforindividualobjects.Iftheobjectisloiteringinsidetheincludeareafor
alongertimethanspecied,analarmtriggers.Theloiteringtimestartscountingwhentheobjectentersanincludearea.If
theobjectleavestheincludeareatheapplicationresetstheindividualloiteringtime.
Iftwoormoreobjectsmoveclosetogether,theysometimesmerge.Themergedobjectisconsideredanewobjectand
inheritsthetimefromtheobjectthathasthelongestloiteringtime.
•Groupmeanstheapplicationtracksthetimefortheentireincludearea.Ifthereisloiteringinsidetheincludeareafora
longertimethanspecied,analarmtriggers.Theapplicationresetsthegrouploiteringtimewhentherehaven'tbeen
anyobjectsintheareaforawhile.
Towatchthisvideo,gotothewebversionofthisdocument.
www.axis.com/products/online-manual/21455#t10060133
Youcancombinetheconditionsbycreatingdifferentproles.Bothconditionscannotbeselectedinthesameprole.SeeHowtoset
upbothindividualloiteringandgrouploiteringonpage14.
Filters
Iftheapplicationtriggerstoomanyunwantedalarms,startbymodifyingtheincludeandexcludeareas.Iftoomanyalarms
arestilltriggered,useoneormoreofthelters:
Smallobjects-Usethistoignoresmallobjects.
Swayingobjects-Usethistoignoreobjectsthatonlymoveashortdistance.
Filterrecommendations
•Filtersareappliedtoallmovingobjectsfoundbytheapplicationandshouldbesetupwithcaretomakesurethat
noimportantobjectsareignored.
•Useasfewltersaspossible.
•Setuponelteratatimeandusevisualconrmationtocheckthesettingsbeforeyouturnonanotherlter.
•Changetheltersettingscarefullyuntilyou’vereachedthedesiredresult.
Thesmallobjectslter
Thesmallobjectslterreducesfalsealarmsbyignoringobjectsthataresmall,forexamplesmallanimals.
Availablesmallobjectslters:
9
AXISLoiteringGuard
Setuptheapplication
•Nodepthissuitableifthereisnooronlyasmalldepthintheimage,andinsituationswhereperspectivecannotbeused.
Itcould,forexample,besituationswhenthecamerahasabird's-eyeviewormonitorsanareawithsignicantdifferences
inelevation.SeeHowtoltersmallobjectsinascenewithnodepthonpage11.
•Depthprovidesthebestfalsealarmreductionandisrecommendedformostinstallations.Selectthisoptionwhenthe
imagehasasignicantdepth,thatis,whenobjectsfarfromthecameraappearsmallerthanobjectsclosetothecamera.
SeeFiltersmallobjectsinascenewithdepthonpage10.
Whentheimagehasasignicantdepth,theperspectiveneedstobecalibrated.Duringcalibration,theapplicationcomparesthe
heightoftheobjectsastheyappearintheimagewiththeactualheightsofthecorrespondingphysicalobjects.Theapplicationuses
thecalibratedperspectivetocalculatetheobjectsizebeforeapplyingthesmallobjectslter.
Note
•Thelterappliestoallobjectsintheimage,notjustobjectsinthesamepositionasthesetuprectangle.
•Theapplicationignoresobjectsthataresmallerthanboththeenteredheightandtheenteredwidth.
Filtersmallobjectsinascenewithdepth
1.Gototheapplication’swebpageandselectanexistingprole,orclicktocreateanewprole.
2.GotoFilters>Smallobjectsandclick
3.Turnonthelterwiththetogglebutton.
4.Selectdepth.
5.Calibratetheperspective.SeeCalibrateperspectiveonpage10.
6.Setthesizeofobjectstoexclude.
IfyouselectAnadult,objectssmallerthan75x75cmareexcluded.
IfyouselectAcustomsize,yousetthesizeofobjectstoexclude.Tonottriggeralarms,objectsmustbesmallerthanboth
theenteredheightandtheenteredwidth.
7.Tochecktheltersettings,movetherectangleintheliveviewandmakesureobjectsthatshouldnottriggeralarmst
insidetherectangle.
Whenyoudragtherectangleintheliveview,itadaptstoshowhowlargeanobjectoftheenteredheightandwidth
isatthatpositionintheimage.
8.ClickFinish.
Calibrateperspective
Placeverticalbarsintheimagetocalibrateperspective.Thebarsrepresentphysicalobjectsatdifferentdistancesfromthecamera.
1.Intheliveview,choosetwoormoreobjectsofknownheight,forexamplehumansorfencepoles,thatarelocatedon
thegroundandatdifferentdistancesfromthecamera.
2.Clickandplaceonebarateachobjectintheliveview.
3.Toadjustthelengthofthebarstomatchtheheightoftheobjectasitappearsintheimage,clickanddragattheendpoints.
4.Foreachbar,enterthecorrespondingobject’sheight.
5.Toimprovethecalibration,addadditionalbars.
10
AXISLoiteringGuard
Setuptheapplication
Example
Ifthereisafencewith2meterhighpolesextendingfromthecameratowardsthehorizon,positionthebarsatthefencepoles,
adjusttheirlengthsandenter200cm(6ft7in)intheelds.
Howtoltersmallobjectsinascenewithnodepth
1.Gototheapplication’swebpageandselectanexistingprole,orclicktocreateanewprole.
2.GotoFilters>Smallobjectsandclick
3.Turnonthelterwiththetogglebutton.
4.Selectnodepth.
5.Changetheobjectsizebydoingoneofthefollowing:
-Toresizetherectangleintheliveview,usethemouse.Theapplicationignoresallobjectsthattinsidethe
rectangle.Tocomparetheltersizewiththesizeofrealobjectsintheimage,placetherectangleindifferent
placesintheliveview.
-Enterthewidthandheightintheelds.
6.ClickFinish.
Theswayingobjectlter
Theswayingobjectslterignoresobjectsthatonlymoveashortdistance,forexampleswayingfoliage,ags,andtheirshadows.If
theswayingobjectsarelarge,forexamplelargepondsorlargetrees,useexcludeareasinsteadofthelter.Thelterisappliedtoall
detectedswayingobjectsand,ifthevalueistoolarge,importantobjectsmightnottriggeractions.
Whentheswayingobjectlteristurnedonandtheapplicationdetectsanobject,theobjectdoesnottriggeranactionuntilit
hasmovedadistancelargerthantheltersize.
Setuptheswayingobjectslter
Thelterignoresanyobjectmovingashorterdistancethanthatfromthecentertotheedgeoftheellipse.
Note
•Thelterappliestoallobjectsintheimage,notjustobjectsinthesamepositionasthesetupellipse.
•Werecommendthatyoubeginwithasmallltersize.
•Iftheswayingobjectlteristoolarge,objectsmightnotfullltheloiteringcriteriaand,inturn,nottriggeralarms.
1.Gototheapplication’swebpageandselectanexistingprole,orclicktocreateanewprole.
2.GotoFilters>Swayingobjectsandclick
3.Turnonthelterwiththetogglebutton.
4.Toresizethelterintheliveview,usethemouseorchangethevalueintheDistanceeld.
5.Tocomparetheltersizewiththesizeofrealobjectsintheimage,placetheellipseindifferentplacesintheliveview.
11
AXISLoiteringGuard
Setuptheapplication
6.ClickDone.
Visualconrmation
Usevisualconrmationtomakesurethatallobjectsthatshouldbedetectedaredetected.
Therearetwotypesofvisualconrmationintheliveview:
•Outlinesonallmovingobjects.Agreenoutlineindicatesthattheapplicationhasdetectedtheobject.Ifanindividual
objectreachesthemaximumtimelimit,theoutlineturnsredandtheapplicationsendsanalarm.Ifgrouploiteringreaches
themaximumtimelimit,thewholeincludeareaturnsredandtheapplicationsendsanalarm.
•Aprogressbarthatshowsupundertheobject.Whentheloiteringobject,orobjects,reachesthemaximumtimelimit,the
progressbarturnscompletelyredandtheapplicationsendsanalarm.
Note
•Visualconrmationcancausevideolatencyandaffectperformanceduringconguration.
•IfyouchangePTZpresetposition,theapplicationneedsafewsecondstorecalibrate.Thiscausesadelaybeforevisual
conrmationshowsupagain.
•Toimproveperformance,visualconrmationautomaticallyturnsoffafter15minutes.
Toturnonvisualconrmation,clickVisualconrmation.
Howtousetheapplicationinmultichannelproducts
Inmultichannelproducts,theapplicationcanbeusedonseveralchannelssimultaneously.Eachvideochannelhasitsownproles
withanincludearea,excludeareas,andlters.
Foracompletelistofsupportedmultichannelproducts,seewww.axis.com
Note
•Runningtheapplicationonseveralchannelssimultaneouslymayaffecttheproduct’sperformance.
•Tousetheapplicationonmultiplechannels,theapplicationmustbeturnedonandconguredforeachchannel.
•Toswitchbetweenchannels,selectfromthelistofchannelsintheliveview.
•Todisableachannelremoveallitsproles.
12
AXISLoiteringGuard
Recordvideowhenthereisanalarm
Recordvideowhenthereisanalarm
ThefollowingexampleexplainshowtosetuptheAxisdevicetorecordvideotoanSDcardwhentheapplicationtriggersanalarm.
1.Intheproduct’swebpage,gotoSettings>Appsandmakesuretheapplicationisrunning.
2.TocheckthattheSDcardismounted,gotoSettings>System>Storage.
3.GotoSettings>System>Eventsandaddarule.
4.Typeanamefortherule.
5.Inthelistofconditions,underApplications,selecttheapplicationprole.Totriggerthesameactionforallproles,
selectAnyProle.
6.Inthelistofactions,underRecordings,selectRecordvideo.
7.Selectanexistingstreamproleorcreateanewone.
8.Inthelistofstorageoptions,selectSDcard.
MakesuretheSDcardismounted.
9.Gobacktotheapplication’swebpage.Totesttherule,clickTestalarmintheliveview.
13
AXISLoiteringGuard
Howtosetupbothindividualloiteringandgrouploitering
Howtosetupbothindividualloiteringandgrouploitering
Thisexampleexplainshowtosetuptwoproleswithdifferentloiteringconditions.
1.Logintotheapplication’swebpage,gotoProlepropertiesandclick
2.Changetheprolenameto“Individualloitering”.
3.GotoLoiteringconditionsandclick
4.SelecttheoptionIndividual.
5.Enterhowlonganindividualobjectisallowedintheincludeareabeforeanalarmtriggers.
6.ClickDone.
7.Clickthetab.
8.GotoProlepropertiesandclick.
9.Changetheprolenameto“Grouploitering”.
10.GotoLoiteringconditionsandclick
11.SelecttheoptionGroup.
12.Enterthemaximumaccumulatedtimeforseveralloiteringobjectsinanincludeareabeforeanalarmtriggers.
13.ClickDone.
14.Setuptwodifferentactionrules,onewithprole“Individualloitering”asatriggerandonewithprole“Grouploitering”
asatrigger.SeeRecordvideowhenthereisanalarmonpage13.
14
AXISLoiteringGuard
Troubleshooting
Troubleshooting
Toomanyfalsealarms
Iftheapplicationtriggersunwantedalarmsforobjectsoutsidetheincludearea,pointthecamerasothattheliveviewonly
coverstheareaofinterest.
15
UserManualVer.M8.2
AXISLoiteringGuardDate:August2022
©AxisCommunicationsAB,2015-2022PartNo.T10060155
/