Testing CARS_API in CARS_Analytics UI#
CARS_Analytics provides the ability to test the CARS_API using the CARS_API tester service. Image recommended parameters are shown in Table 43.
Table 43. Image recommended parameters
| Parameter | Requirements |
|---|---|
| Resolution | from 100x100 px to 1920x1080 px |
| Maximum file size | 3 Mb |
| Image color | Color or black and white image |
| Image format | JPEG or PNG |
| Frame composition | - Objects must be fully visible (not blocked by other objects) |
| - When recognizing vehicle attributes, the image should not contain more than one vehicle | |
| - LP should occupy the entire area of the image when only LP attributes are recognized |
CARS_API tester is available at the following address:
http://<IP_address>:8080/cars_api_tester
The CARS_Analytics UI administrator account is used to sign in.
The CARS_API tester interface is shown in Figure 7.
Table 44. Description of interface elements
| № | Description |
|---|---|
| 1 | IP address of the tested CARS_API. The IP address is set at the installation stage |
| 2 | CARS_API version |
| 3 | List of available classifiers |
| 4 | List of available detectors |
| 5 | Request type: |
| - Vehicle/License plate classify | |
| - Vehicle/License plate detect | |
| - Vehicle frame processing | |
| - Animal detect | |
| - Smoke/Fire detect | |
| - Vehicle matching |
«Vehicle/License plate classify» request#
The «Vehicle/License plate classify» request allows you to get the attributes of the vehicle and LP.
The «Vehicle/License plate classify» request interface (Figure 8).
The algorithm for submitting a request is provided in Table 45.
Table 45. Description of interface elements
| № | Description |
|---|---|
| 1 | Fields for uploading images of the vehicle or LP. Click  and select the image in the explorer window that appears. Images must comply with the requirements (Table 39). To reset the image, click on  to the right of the uploaded image |
| 2 | List of classifiers that need to process images. To submit a request, at least one classifier must be selected for each uploaded image |
| 3 | Confirmation of sending the request. To send a request, click the «Send!» button |
| 4 | The result of image processing. The result is displayed as a list of all requested classifiers. By default, the results are hidden, to view each classifier, click on  in the title bar. In the documentation «LUNA CARS_API Administration Manual» you can find a description of all available classifiers |
«Vehicle/License plate detect» request#
The «Vehicle/License plate detect» request detects all vehicles and LP in the image. The response returns the attributes of the detected objects (coordinates and dimensions of the BBox).
The «Vehicle/License plate detect» request interface (Figure 9).
The algorithm for submitting a request is provided in Table 46.
Table 46. Description of interface elements
| № | Description |
|---|---|
| 1 | Fields for uploading images. Click and select the image in the explorer window that appears. Images must comply with the requirements (Table 39). To reset the image, click on to the right of the uploaded image |
| 2 | List of detectors that need to process the image (at least one detector must be selected to send a request): |
| - car – vehicle detector | |
| - grz – LP detector | |
| 3 | Confirmation of sending the request. To send a request, click the «Send!» button. If you need to display an image with a BBox, set the «Visualize detections» flag |
| 4 | The result of image processing. The result is displayed as a list of all requested detectors. By default, the results are hidden, to view each detector, click on in the line of the detector name. The response includes information on each detected vehicle and LP: |
| - BBox coordinates | |
| - original image from BBox on each detected vehicle or LP | |
| - miniatures of detected vehicles | |
| Clicking on the image will save the image |
«Vehicle frame processing» request#
The «Vehicle frame processing» request emulates the CARS_API for a single image. As a result of executing this query, CARS_Analytics will generate an event on the input image. Processing will occur for all classifiers.
The Classify request interface (Figure 12).
The algorithm for submitting a request is provided in Table 47.
Table 47. Description of interface elements
| № | Description |
|---|---|
| 1 | Fields for uploading images. Click and select the image in the explorer window that appears. Images must comply with the requirements (Table 39). To reset the image, click on to the right of the uploaded image. When the Save as Event flag is activated, the result of the query execution will be saved as an event (it will be displayed in the Events section of the CARS_Analytics UI). When the Detect License plate only flag is activated, detection will be performed only for LP with subsequent recognition of attributes |
| 2 | Camera name.Y Enter a camera name in this parameter. This name will be passed to CARS_Analytics as the name of the source that captured the event |
| 3 | Confirmation of sending the request. To send a request, click the «Send!» button |
| 4 | The result of image processing. The result is displayed as a list of all detected objects. By default, the results are hidden, to view each object, click on in the title bar. The answer includes: |
| - Vehicle image with BBox around the vehicle | |
| - Thumbnails of detected vehicles and LP | |
| - Stream message – summary information on all received attributes | |
| - car_brand_model_v2 – vehicle brand and model | |
| - vehicle_type – vehicle type | |
| - detailed_vehicle_emergency_v2 – determine the affiliation of a vehicle to emergency services and the presence of flashing lights | |
| - detailed_vehicle_color – color type and color of the vehicle | |
| - vehicle_descriptor_v2 – vehicle descriptor | |
| - public_transport_type – type of public vehicle | |
| - special_transport_type – type of special vehicle | |
| - vehicle_axles – vehicle's axles: their coordinates and count | |
| - vehicle_orientation_v1 – orientation of a vehicle | |
| - vehicle_position_v1 – position of a vehicle |
«Animal detect» request#
The «Animal detect» request allows to recognize the animals in the image.
«Animal detect» request interface (Figure 14).
The algorithm for submitting a request is provided in Table 48.
Table 48. Description of interface elements
| № | Description |
|---|---|
| 1 | Fields for uploading images. Click and select the image in the explorer window that appears. To reset the image, click on to the right of the uploaded image |
| 2 | Confirmation of sending the request. To send a request, click the «Send!» button |
| 3 | The result of image processing. The result is displayed as a list of results of image processing using animal detector, which contains all detected objects. The query response includes: |
| - Image of the animals selected BBox around | |
| - Thumbnails of detected animals | |
| - Stream message – summary information on all received attributes | |
| - Detector information: | |
| - type - animal type (big_animal, small_animal, bird) |
«Smoke/Fire detect» request#
The «Smoke/Fire detect» request allows detect smoke and/or fire using a classifier.
«Smoke/Fire detect» request interface (Figure 16).
The algorithm for submitting a request is provided in Table 49.
Table 49. Description of interface elements
| № | Description |
|---|---|
| 1 | Fields for uploading images. Click and select the image in the explorer window that appears. To reset the image, click on to the right of the uploaded image |
| 2 | Set the parameters to split the image into zones. The detector splits the image into a specified number of zones vertically and horizontally: |
| - Number block of image in height - number of zones in vertical | |
| - Number block of image in width - number of zones in horizontal | |
| 3 | Confirmation of sending the request. Press «Send!» button to send the request |
| 4 | Result of image processing. The result is displayed as a list of the results of image processing with the smoke/fire detector, which contains all detected objects. The query response includes: |
| - Image with highlighted areas where fire/smoke is detected | |
| - Miniatures of the detected zones | |
| - Stream message – summary information on all received attributes | |
| - Detector information: | |
| - type - smoke/fire type (fire, black_smoke, white_smoke) |
Only areas with detected fire/smoke attributes are highlighted in the final image.
«Vehicle matching» request#
The «Vehicle matching» request allows determining similarities between vehicles. This method compares images or descriptors, returning a similarity score.
«Vehicle matching» request interface (Figure 18).
The algorithm for submitting a request is provided in Table 50.
Table 50. Description of interface elements
| № | Description |
|---|---|
| 1 | Fields for uploading images. Click and select an image from the file explorer window that appears. To reset the image, click to the right of the uploaded image |
| 2 | Confirmation of request submission. To submit the request, click the «Send!» button |
| 3 | Image processing result. The result is displayed as a list of processed image results using the image matching method, containing all detected objects. The response to the request includes: |
| - Image of the first original vehicle | |
| - Image of the second vehicle for similarity determination | |
| - Similarity score (how similar the vehicles are) | |
| - Stream message – summary information on all received attributes |
