AXIS Direction Detector

AXIS Direction Detector is an analytic software that monitors in what direction people are passing under a camera. If a person is moving in one of the directions, the application can trigger an alarm.

AXIS Direction Detector includes AXIS People Counter functionality.

In addition to the instructions in the camera’s Installation Guide, there are some important steps to follow for the application to behave in the expected way:

• We recommend that you install the camera at a minimum height of 270 cm (8.9 ft).

• As a rule-of-thumb, the camera covers an area as wide as the camera’s mounting height. For details about a specific camera model, see the Camera selector for AXIS People Counter

• After installation, the covered area can be increased depending on the camera’s zoom setting.

• If the camera is mounted high enough, you can get a coverage width of 8 meters. You can cover even wider entrances by using multiple counters.

• The camera must be mounted straight above the point where people pass.

• 

• Make sure the camera is facing straight down, in line with the ceiling.

• 

• If you install the application before you install the camera, you can use the counting area indicated in the live view to position the camera. The counting area should go from left to right, perpendicular to the path where people cross.

• Make sure there is sufficient white light or IR illumination on site.

• 

• Make sure that there are no continuously moving objects in the counting area. For example, do not install the camera above an escalator.

• 

• Make sure there are no moving objects interfering in the counting area. For example, do not install the camera too close to a door.

• 

• Avoid getting very strong light, like sunlight, and sharp shadows in the camera view.

• 

For more information about how to find and assign IP addresses, go to How to assign an IP address and access your device.

1. Open a browser and enter the IP address or host name of the Axis device.

   If you do not know the IP address, use AXIS IP Utility or AXIS Device Manager to find the device on the network.

2. Enter the username and password. If you access the device for the first time, you must set the root password. See Set a new password for the root account.

3. The live view page opens in your browser.

The device password is the primary protection for your data and services. Axis devices do not impose a password policy as they may be used in various types of installations.

To protect your data we strongly recommend that you:

• Use a password with at least 8 characters, preferably created by a password generator.

• Don’t expose the password.

• Change the password at a recurring interval, at least once a year.

1. Type a password. Follow the instructions about secure passwords. See Secure passwords.

2. Retype the password to confirm the spelling.

3. Click Create login. The password has now been configured.

1. Install the camera on your network..

2. Go to the camera’s web interface in your browser, see the user manual for the camera.

3. Go to Apps.

4. Upload the application file (.eap) to the camera.

5. Activate the license. If you’re online, enter the license code. The application automatically activates the license.

How to activate the license when you’re offline

1. To activate the license when you’re offline, you need a license key. If you don’t have a license key on the computer, do the following:

2. Go to www.axis.com/applications

3. Go to License key registration. You need the license code and the Axis device serial number.

4. Save the license key file on the computer and select the file when the application asks for it.

1. In the camera’s web interface, go to Apps, start the application and click Open.

The date and time settings are important for your camera to keep the correct time for a longer period of time, and for the statistics to be attributed to the correct time. You set the date and time in the camera’s web interface.

1. In the camera’s web interface, go to System > Date and time.

2. For more information about date and time settings, click .

You can create user accounts with different privileges, so that unauthorized staff can view statistics but not change any settings of the counter.

You create user accounts in the camera’s web interface.

1. In the camera’s web interface, go to System > Users.

2. For more information about user accounts, click .

To check if the application is calibrated for your camera, go to the Camera selector for AXIS People Counter tool.

1. In the application’s web interface, go to Settings > General.

2. Make sure Status is on.

3. In the Name field, type the name of the camera or location.

   This can be for example “Axis_Main_entrance_T_building”. All cameras need to have unique names.

4. Set Calibration mode. Do one of the following:

5. • If the application is calibrated for your camera, select Height setting. Type the mounting height in the Visual height field.

   • If the application is not calibrated, select Manual setting and click Setup. Place a person underneath the camera and adjust the size of the yellow box so that it covers just one person.

6. If you need to zoom in, do one of the following:

7. • Turn on Digital zoom and click Setup.

   • If the camera has optical zoom, you need to go to the camera’s web interface to adjust the zoom.

8. Set Direction in to Up or Down, depending on the direction of the people passing by in live view.

9. To adjust the counting area, go to Adjust the counting area.

In the live view image, the counting area is indicated by two blue lines and a red area. A person needs to pass through the red area to be counted.

Use the curvature settings to change the shape so that it is natural for people to pass through the counting area. Keep the curvature as close to a straight angle as possible.

1. Go to Settings > Counting zone.

2. To move the entire counting area up or down, use the Line offset slider. How much you can move it depends on the counting area size.

3. To adjust the height of the counting area, use the Counting zone height slider.

4. To adjust the width of the counting area, use the Counting zone width slider. How much you can adjust it depends on the camera’s mounting height.

5. To use a curved counting area, select Curved line and then adjust the radius with the Radius slider.

6. To change the direction of the curvature, click the Radius icon.

7. Click Submit to save the settings when you are done.

8. You might need to fine-tune the counter for the best possible performance, see Validate the system.

If you need to cover a wide entrance with several counters you can set up multiple cameras, also called Neighbor counters. To calculate how many cameras are needed to cover the entire width of the entrance, use the Camera selector for AXIS People Counter.

The primary camera overrides the following settings on the secondary cameras:

• Visual height

• Counter sensitivity

• Digital zoom

• Network & time

• Line offset

• Counting zone height

• Counting schedule

1. Mount the cameras side by side following the measurements indicated by the camera selector tool.

2. Go to the primary camera application web interface and select Settings > Advanced > Neighbor counters.

3. Select Enable as primary.

4. If you have a secondary camera that you want to connect to:

5. 1. Go to the secondary camera.

   2. Go to Advanced > Neighbor counters.

   3. Select Display connection key

   4. Click Copy connection key.

   5. Return to the primary camera.

   6. Paste the text under Connection key.

6. Note

   If you don’t have a secondary camera, you can leave the Connection key field empty.

7. Note

   If the cameras are configured to send data to AXIS Store Data Manager, make sure that only the primary camera is connected. The primary camera automatically uploads the data from all the secondary cameras as one single unit.

8. Click Submit.

9. When you have connected all cameras, go to Calibrate secondary position.

10. Place an object, for example a sheet of paper, at the exact mid-point between the two cameras. It’s very important that you place the object exactly in the middle of the two cameras since the object is used as a reference point to calibrate the cameras.

11. Drag the view of the secondary camera over the primary camera view. Try to avoid vertical offset.

12. 
13. 
    1. Primary camera view
    2. Secondary camera view
    3. Reference object

14. Once the calibration is done, go to Live view in the primary camera to view all of the secondary cameras.

If you can’t see the video stream from the secondary cameras in the primary camera, make sure that there are no other connections to the secondary cameras running.

1. Go to Settings > AXIS Direction Detector to access the camera’s webpage.

2. In the event setup, use the trigger Applications.

3. Follow the built-in instructions to set up an event in the camera.

The application automatically disables the counting functionality when it gets dark. If you want to limit the counting further, you can set up a schedule.

1. Go to Settings > Counting schedule.

2. To adjust start and stop times, move any of the sliders. To set individual schedules for each day of the week, select Per day schedule and then move the corresponding sliders.

Turn off the application on a specific day of the week

Clear the checkbox next to the slider.

You can configure the application so that people can no longer be identified from the camera.

Anonymize soft

This feature blocks all video streams and images from the camera. The live view still shows a blurred image which means you can still see what is going on but you can't identify people.

1. Go to Maintenance > Anonymize.

2. Click Anonymize soft.

3. To go back to normal mode, click Reset anonymization. Only users with an administrator account can do this.

Use the copy functionality if you want to copy the application settings to, for example, other cameras in the same store with the same mounting height. Camera-specific settings, such as the application license and camera name, are not included.

1. To copy the application settings, go to Maintenance > Parameter backups.

2. Click Copy. The computer saves the file in your browser’s default folder for downloads.

When you have installed and set up all cameras in the building, we recommend that you validate the accuracy and fine-tune the system. This is likely to increase the accuracy or identify any problems with the counters.

To get an overview, go to Statistics and look at the counting data for a couple of days back. If the difference between number of persons going in and out is <5% it’s a good first indication that the system is configured correctly.

If the difference is greater than that, follow the instructions inValidate the counter.

1. Go to Live view.

2. Click Test accuracy.

3. To hide the automatic counter, click Hide.

4. Click Start and manually count 100 or more passages by pressing the up and down arrows on your keyboard. You can also click In and Out.

5. If you need to start over, click Reset.

6. Click Result when you are done.

7. Check the accuracy table. Under normal circumstances, the total accuracy percentage should be 95 % or higher.

If you’re not satisfied with the accuracy of the counter, see Fine-tune the counter.

1. Make sure the camera is mounted according to the instructions in Mount the camera.

2. Go to Settings > General.

3. Go to the Counter sensitivity slider, or click Setup if the counter is running in manual mode, and do one of the following:

4. • If the counter is counting too many compared to the control figure, decrease the counter sensitivity with about 20 units or increase the size of the yellow box slightly.

   • If the counter is counting too few compared to the control figure, increase the counter sensitivity with about 20 units or decrease the size of the yellow box slightly.

5. Validate the accuracy again, see Validate the counter.

There are several ways to use the statistics from the counter:

• In the application’s web interface, view real-time counting data in the built-in graphs.

• View built-in graphs in day and week view from the statistics page. The data is updated in real time.

  Data is available on the camera for up to 90 days and updated every 15 minutes. The data is stored in 15-minute bins representing the in and out counts for the 15-minute periods.

• Download data through an open API. See VAPIX® Library.

• Use AXIS Store Data Manager, a software package that acts as a central point to store and manage data collected from all devices. See Connect a camera to a folder in AXIS Store Data Manager.

• Use AXIS Store Reporter, a statistical web-based solution, for managing and monitoring historical data.

• Download statistics to your computer, see Download statistics.

To perform this task, the application must be installed on the camera.

1. In AXIS Store Data Manager, go to Sources and get the Folder connection identifier and the Folder connection password for the folder you want to connect to.

2. In the camera’s web interface, go to Settings > Apps and open the application’s web interface.

3. In the application’s web interface, go to Settings > Reporting.

4. To enable pushing data to a server, select Enabled.

5. Enter the web address for AXIS Store Data Manager, for example https://[subdomain].asdm.axis.com/datamanager where [subdomain] is replaced by a unique name.

6. Enter the Folder connection identifier and Folder connection password.

7. To test the connection, click Run test.

8. Click Submit.

1. Go to Statistics > Download statistics.

2. Select the file format:

3. • If you select .xml, .csv or .json format you can also select the time interval.

   • File format .cnt is a proprietary, binary format, available for compatibility reasons.

4. Select date in the calendar. The data is presented in a new tab in your browser.

5. If you want to save the data as a local file on the computer, right-click and select Save as. The browser saves the file in the default download folder.

6. If you want to download all available data, click Download all next to the file format.

If the counting is inaccurate or the web interface unusually slow, you can try restarting the running services or restart the device.

To restart the device, go to Maintenance > Restart.

Go to Maintenance > Reset and do one of the following:

• To clear all counting data from the camera, click Clear data.

• To restore all settings of the application to default, click Restore settings.

1. To back up the application settings, go to Maintenance > Parameter backups.

2. Click Backup. The computer saves the file in your browser’s default folder for downloads.

1. Go to Maintenance > Parameter backups.

2. Browse to select the previously saved backup file and then click Restore.

If you have any trouble with your device you can generate a log report.

1. Go to Maintenance > Logs.

2. Click Generate logs.

3. The browser saves the file on the default download browser on the computer.

4. Attach the log report when submitting an issue to support.

Go to Maintenance > Registration.

• To register a license, click on the Registration page.

• If you want to remove you license from this product, click Clear registration.

• If you have an updated license, click Renew license.

There is a light-weight version of the web interface at the URL http://<servername>/people-counter/lite/index.html. These pages can for instance be used to embed the application into systems, for example AXIS Camera Station or Milestone's XProtect Smart Client.

There are four pages available:

• http://<servername>/local/tvpc/lite/day.html: The page shows the day plot, the same plot that can be seen on the Statistics page.

• http://<servername>/local/tvpc/lite/week.html: The page shows the week plot, the same plot that can be seen on the Statistics page.

• http://<servername>/local/tvpc/lite/count.html: A page that shows the live count for the current day.

• http://<servername>/local/tvpc/lite/liveview.html: A slim version of the live view page that shows live count and the video stream with the counting area as overlay.

The menu at the bottom of the pages can be disabled by appending ?clean to the URL:s above, e.g. http://<servername>/local/tvpc/lite/liveview.html?clean. You can also add a lang tag before lite to display these pages in other languages, example http://<servername>/local/tvpc/cn/lite/liveview.html

AXIS People Counter is an application accessible on your indoor Axis camera that provides simultaneous two-way counting of people, which lets you analyze visitor trends such as peak visitor hours. It is also able to estimate occupancy levels in real-time and provide access to data on the number of people present on either the premises or in a certain area at a certain time. This is helpful when you want to understand occupancy trends that enables you to measure if the occupancy levels exceed a set threshold.

Additionally, the application can detect and notify if more than one person enters within a set time interval or move in the wrong direction. This means that if you set up the application over a one-way entrance you will receive a notification whenever someone tries to leave or if more than one person tries to enter at the same time.

Example

Request real time data from the People Counter

Request

http://<servername>/local/tvpc/.api?live-sum.json

Return

{
  "serial":"00408CAC512B",
  "name":"Exit south",
  "timestamp":"20170503112756",
  "in":12,
  "out":318
}

See Request real-time data for additional information.

Example

List all days of data available on the People Counter

Request

http://<servername>/local/tvpc/.api?list-cnt.json

Return

{
  "timestamp" : "20170513132513",
  "days":["20170510", "20170511", "20170513"]}
}

See List available data for additional information.

Example

Request historical data for the 12th to the 15th of May 2017

Request

http://<servername>/local/tvpc/.api?export-cnt&date=20170512-20170515

See Download binary data for additional information.

Example

Request all available historical data

Request

http://<servername>/local/tvpc/.api?export-cnt&date=all

See Download binary data for additional information.

Example

Request historical CSV data for the 12th and the 15th of May 2017 with 15-minute resolution

Request

http://<servername>/local/tvpc/.api?export-csv&date=20170512,20170515&res=15m

See Request CSV data for additional information.

Example

Request historical data for all available days, with 24-hour resolution

Request

http://<servername>/local/tvpc/.api?export-csv&date=all&res=24h

See Request CSV data for additional information.

Example

Request historical XML data for the 12th and the 15th of May 2017 with 15-minute resolution

Request

http://<servername>/local/tvpc/.api?export-xml&date=20170512,20170515&res=15m

See Request XML data for additional information.

Example

Request Live view information from the People Counter

Request

http://<servername>/local/tvpc/.api?cntpos.json

Response

{
  "width":320,
  "height":240,
  "left":0,
  "right":296,
  "top":88,
  "bottom":224,
  "yfirst":88,
  "ylast":152,
  "radius":0
}

See Live view information for additional information.

Returns JSON file with real time counting data.

Format:

JSON

Method:

GET

http://<servername>/local/tvpc/.api?live-sum.json

{
  "serial":"<camera-serial>",
  "name":"<counter-name>",
  "timestamp":"<timestamp>",
  "in":<in>,
  "out":<out>
}

Returns a list of days where data exists.

Format:

JSON

Method:

GET

http://<servername>/local/tvpc/.api?list-cnt.json

{
  "timestamp" : "<timestamp>",
  "days":["YYYYMMDD", [..] "YYYYMMDD"]}
}

This script returns a binary data file for the given date(s), to be used in AXIS Store Data Manager

Format:

cnt

Method:

GET

http://<servername>/local/tvpc/.api?export-cnt&date=<date>

Return

A binary data file for the given date(s).

Returns historical data in CSV format

Format:

CSV

Method:

GET

http://<servername>/local/tvpc/.api?export-csv[&date=<date>][&res=<res>]

Return

This script returns data in plain text, comma-separated values. The first line contains a description of each element, and the following lines contain the corresponding data for the chosen time interval and resolution.

Returns historical data in XML format

Format:

XML

Method:

GET

http://<servername>/local/tvpc/.api?export-xml[&date=<date>][&res=<res>]

Return

This script returns data in XML format. The DTD file can be found at: http://<servername>/local/tvpc/appdata.dtd

Returns historical data in JSON format

Format:

JSON

Method:

GET

http://<servername>/local/tvpc/.api?export-json[&date=<date>][&res=<res>]

Return

This script returns data in JSON format.

Format:

text/plain

Method:

GET

http://<servername>/local/tvpc/.apioperator?clear-data

OK

Returns information about the placement of the lines in Live view.

Format:

JSON

Method:

GET

http://<servername>/local/tvpc/.api?cntpos.json

{
  "width":<width>,
  "height":<height>,
  "left":<left>,
  "right":<right>,
  "top":<top>,
  "bottom":<bottom>,
  "yfirst":<yfirst>,
  "ylast":<ylast>,
  "radius":<radius>
}

Format:

text/plain

Method:

GET

http://<servername>/local/tvpc/.apioperator?show-logs

Return

Displays the system logs.

Format:

tar.gz

Method:

GET

http://<servername>/local/tvpc/.apioperator?generate-logs

Return

A log archive

Format:

JSON

Method:

GET

http://<servername>/local/tvpc/.api?params.json

Return

A JSON object of all the People Counter related parameters.

Format:

text

Method:

POST

The post format has a format where pairs and values need to be specified, best described by an example: &p1=Counter.Enable&v1=1&p2=Counter.Height&v2=280&setparams=needstobeincluded

http://<servername>/local/tvpc/.apioperator?setparams

OK