pystruct.inference.inference_ad3¶

pystruct.inference.inference_ad3(unary_potentials, pairwise_potentials, edges, relaxed=False, verbose=0, return_energy=False, branch_and_bound=False)[source]¶

Inference with AD3 dual decomposition subgradient solver.

Parameters:

Parameters:	unary_potentials : nd-array, shape (n_nodes, n_nodes) Unary potentials of energy function. pairwise_potentials : nd-array, shape (n_states, n_states) or (n_states, n_states, n_edges). Pairwise potentials of energy function. If the first case, edge potentials are assumed to be the same for all edges. In the second case, the sequence needs to correspond to the edges. edges : nd-array, shape (n_edges, 2) Graph edges for pairwise potentials, given as pair of node indices. As pairwise potentials are not assumed to be symmetric, the direction of the edge matters. relaxed : bool (default=False) Whether to return the relaxed solution (`True`) or round to the next integer solution (`False`). verbose : int (default=0) Degree of verbosity for solver. return_energy : bool (default=False) Additionally return the energy of the returned solution (according to the solver). If relaxed=False, this is the energy of the relaxed, not the rounded solution. branch_and_bound : bool (default=False) Whether to attempt to produce an integral solution using branch-and-bound.
Returns:	labels : nd-array Approximate (usually) MAP variable assignment. If relaxed=False, this is a tuple of unary and edge ‘marginals’.

unary_potentials : nd-array, shape (n_nodes, n_nodes)

Unary potentials of energy function.

pairwise_potentials : nd-array, shape (n_states, n_states) or (n_states, n_states, n_edges).

Pairwise potentials of energy function. If the first case, edge potentials are assumed to be the same for all edges. In the second case, the sequence needs to correspond to the edges.

edges : nd-array, shape (n_edges, 2)

Graph edges for pairwise potentials, given as pair of node indices. As pairwise potentials are not assumed to be symmetric, the direction of the edge matters.

relaxed : bool (default=False)

Whether to return the relaxed solution (True) or round to the next integer solution (False).

verbose : int (default=0)

Degree of verbosity for solver.

return_energy : bool (default=False)

Additionally return the energy of the returned solution (according to the solver). If relaxed=False, this is the energy of the relaxed, not the rounded solution.

branch_and_bound : bool (default=False)

Whether to attempt to produce an integral solution using branch-and-bound.

Returns:

labels : nd-array

Approximate (usually) MAP variable assignment. If relaxed=False, this is a tuple of unary and edge ‘marginals’.