org.cripac.isee.pedestrian.reid

Class ExternPedestrianComparerUsingAttr

java.lang.Object

org.cripac.isee.alg.pedestrian.reid.PedestrianComparerUsingAttr

org.cripac.isee.alg.pedestrian.reid.ExternPedestrianComparerUsingAttr

public class ExternPedestrianComparerUsingAttr
extends PedestrianComparerUsingAttr

ExternPedestrianComparerWithAttr is a pedestrian comparer using attributes that depend on external solvers connected with sockets. It sends comparison requests each containing two package of pedestrian information to the solver, then receives responses containing the similarity and feature vector (optional). The requests and responses are processed asynchronously, matched by request UUID.

Request format

16 bytes - Request UUID.

foreach pedestrian (totally 2): {

1 byte - 0: Full data; 1: Feature only (featFlag)

if featFlag: Feature.LENGTH bytes - Known feature.

else: {

4 bytes - Tracklet length (number of bounding boxes).

foreach bounding box: {

16 bytes - Bounding box data (x, y, width, height).

width * height * 3 bytes - Image data.

}

4 bytes - Length of JSON string representing attributes (jsonLen).

jsonLen bytes - UTF-8 JSON string representing attributes.

}

}

Response format

16 bytes - Request UUID.

4 bytes - Similarity.

foreach pedestrian (totally 2): {

1 byte - Whether returning the feature vector (retFlag).

if retFlag: Feature.LENGTH bytes (Optional) - The feature vector of the pedestrian.

}

Author:

Ken Yu, CRIPAC, 2016

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	ExternPedestrianComparerUsingAttr.RequestMessage The RequestMessage is a class specializing the format of request messages of ExternPedestrianComparerWithAttr to extern solvers.

Constructor Summary

Constructors

Constructor and Description
ExternPedestrianComparerUsingAttr(java.net.InetAddress solverAddress, int port) Constructor of ExternPedestrianComparerWithAttr specifying extern solver's address and listening port.
ExternPedestrianComparerUsingAttr(java.net.InetAddress solverAddress, int port, boolean enableFeatureOnly) Constructor of ExternPedestrianComparerWithAttr specifying extern solver's address and listening port.

Method Summary

Modifier and Type	Method and Description
float	compare(PedestrianInfo personA, PedestrianInfo personB) Compare two pedestrians each given in a track with attributes.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ExternPedestrianComparerUsingAttr

public ExternPedestrianComparerUsingAttr(@Nonnull
                                         java.net.InetAddress solverAddress,
                                         int port)
                                  throws java.io.IOException

Constructor of ExternPedestrianComparerWithAttr specifying extern solver's address and listening port.

Parameters:

solverAddress - the address of the solver.

port - the port the solver is listening to.

Throws:

java.io.IOException - if an I/O error occurs when creating the socket.

ExternPedestrianComparerUsingAttr

public ExternPedestrianComparerUsingAttr(@Nonnull
                                         java.net.InetAddress solverAddress,
                                         int port,
                                         boolean enableFeatureOnly)
                                  throws java.io.IOException

Constructor of ExternPedestrianComparerWithAttr specifying extern solver's address and listening port.

Parameters:

solverAddress - the address of the solver.

port - the port the solver is listening to.

enableFeatureOnly - whether to enable comparing pedestrians with feature only.

Throws:

java.io.IOException - if an I/O error occurs when creating the socket.

Method Detail

compare

public float compare(@Nonnull
                     PedestrianInfo personA,
                     @Nonnull
                     PedestrianInfo personB)
              throws java.lang.Exception

Description copied from class: PedestrianComparerUsingAttr

Compare two pedestrians each given in a track with attributes.

Specified by:

compare in class PedestrianComparerUsingAttr

Parameters:

personA - The first pedestrian.

personB - The second pedestrian.

Returns:

The similarity between them.

Throws:

java.io.IOException

java.lang.Exception