org.cripac.isee.alg.pedestrian.reid

Class ExternPedestrianComparerUsingAttr

java.lang.Object

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

All Implemented Interfaces:

PedestrianComparerUsingAttr

public class ExternPedestrianComparerUsingAttr
extends Object
implements 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.
private class	ExternPedestrianComparerUsingAttr.ResultListener The ResultListener class listens to the socket for comparison results then store them into the result pool.

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	enableFeatureOnly
private Thread	resListeningThread
private Map<UUID,Float>	resultPool
private Socket	socket

Constructor Summary

Constructors

Constructor and Description
ExternPedestrianComparerUsingAttr(InetAddress solverAddress, int port) Constructor of ExternPedestrianComparerWithAttr specifying extern solver's address and listening port.
ExternPedestrianComparerUsingAttr(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

Field Detail

socket

private final Socket socket

resListeningThread

private Thread resListeningThread

resultPool

private final Map<UUID,Float> resultPool

enableFeatureOnly

private boolean enableFeatureOnly

Constructor Detail

ExternPedestrianComparerUsingAttr

public ExternPedestrianComparerUsingAttr(@Nonnull
                                         InetAddress solverAddress,
                                         int port)
                                  throws 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:

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

ExternPedestrianComparerUsingAttr

public ExternPedestrianComparerUsingAttr(@Nonnull
                                         InetAddress solverAddress,
                                         int port,
                                         boolean enableFeatureOnly)
                                  throws 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:

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

Method Detail

compare

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

Compare two pedestrians each given in a track with attributes.

Specified by:

compare in interface PedestrianComparerUsingAttr

Parameters:

personA - The first pedestrian.

personB - The second pedestrian.

Returns:

The similarity between them.

Throws:

Exception