pystruct.inference.inference_lp¶

pystruct.inference.inference_lp(unary_potentials, pairwise_potentials, edges, relaxed=False, return_energy=False, **kwargs)[source]¶

Inference with build-in LP solver using cvxopt backend.

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`). 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.
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).

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.

Returns:

labels : nd-array

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