pub_tree.h File Reference

Detailed Description

public methods for branch and bound tree

Author

Tobias Achterberg

Definition in file pub_tree.h.

#include "scip/def.h"
#include "scip/type_misc.h"
#include "scip/type_tree.h"
#include "scip/type_reopt.h"

Go to the source code of this file.

Functions
	SCIP_DECL_SORTPTRCOMP (SCIPnodeCompLowerbound)
void	SCIPnodeGetParentBranchings (SCIP_NODE *node, SCIP_VAR **branchvars, SCIP_Real *branchbounds, SCIP_BOUNDTYPE *boundtypes, int *nbranchvars, int branchvarssize)
void	SCIPnodeGetAncestorBranchings (SCIP_NODE *node, SCIP_VAR **branchvars, SCIP_Real *branchbounds, SCIP_BOUNDTYPE *boundtypes, int *nbranchvars, int branchvarssize)
void	SCIPnodeGetAncestorBranchingsPart (SCIP_NODE *node, SCIP_NODE *parent, SCIP_VAR **branchvars, SCIP_Real *branchbounds, SCIP_BOUNDTYPE *boundtypes, int *nbranchvars, int branchvarssize)
SCIP_RETCODE	SCIPnodePrintAncestorBranchings (SCIP_NODE *node, FILE *file)
void	SCIPnodeGetAncestorBranchingPath (SCIP_NODE *node, SCIP_VAR **branchvars, SCIP_Real *branchbounds, SCIP_BOUNDTYPE *boundtypes, int *nbranchvars, int branchvarssize, int *nodeswitches, int *nnodes, int nodeswitchsize)
SCIP_Bool	SCIPnodesSharePath (SCIP_NODE *node1, SCIP_NODE *node2)
SCIP_NODE *	SCIPnodesGetCommonAncestor (SCIP_NODE *node1, SCIP_NODE *node2)
SCIP_NODETYPE	SCIPnodeGetType (SCIP_NODE *node)
SCIP_Longint	SCIPnodeGetNumber (SCIP_NODE *node)
int	SCIPnodeGetDepth (SCIP_NODE *node)
SCIP_Real	SCIPnodeGetLowerbound (SCIP_NODE *node)
SCIP_Real	SCIPnodeGetEstimate (SCIP_NODE *node)
SCIP_REOPTTYPE	SCIPnodeGetReopttype (SCIP_NODE *node)
unsigned int	SCIPnodeGetReoptID (SCIP_NODE *node)
void	SCIPnodeSetReopttype (SCIP_NODE *node, SCIP_REOPTTYPE type)
void	SCIPnodeSetReoptID (SCIP_NODE *node, unsigned int id)
void	SCIPnodeGetNDomchg (SCIP_NODE *node, int *nbranchings, int *nconsprop, int *nprop)
SCIP_DOMCHG *	SCIPnodeGetDomchg (SCIP_NODE *node)
SCIP_NODE *	SCIPnodeGetParent (SCIP_NODE *node)
SCIP_Bool	SCIPnodeIsActive (SCIP_NODE *node)
SCIP_Bool	SCIPnodeIsPropagatedAgain (SCIP_NODE *node)

Function Documentation

SCIP_DECL_SORTPTRCOMP

(

SCIPnodeCompLowerbound

)

node comparator for best lower bound

void SCIPnodeGetParentBranchings	(	SCIP_NODE *	node,
		SCIP_VAR **	branchvars,
		SCIP_Real *	branchbounds,
		SCIP_BOUNDTYPE *	boundtypes,
		int *	nbranchvars,
		int	branchvarssize
	)

returns the set of variable branchings that were performed in the parent node to create this node

Parameters

node	node data
branchvars	array of variables on which the branching has been performed in the parent node
branchbounds	array of bounds which the branching in the parent node set
boundtypes	array of boundtypes which the branching in the parent node set
nbranchvars	number of variables on which branching has been performed in the parent node if this is larger than the array size, arrays should be reallocated and method should be called again
branchvarssize	available slots in arrays

void SCIPnodeGetAncestorBranchings	(	SCIP_NODE *	node,
		SCIP_VAR **	branchvars,
		SCIP_Real *	branchbounds,
		SCIP_BOUNDTYPE *	boundtypes,
		int *	nbranchvars,
		int	branchvarssize
	)

returns the set of variable branchings that were performed in all ancestor nodes (nodes on the path to the root) to create this node

Parameters

node	node data
branchvars	array of variables on which the branchings has been performed in all ancestors
branchbounds	array of bounds which the branchings in all ancestors set
boundtypes	array of boundtypes which the branchings in all ancestors set
nbranchvars	number of variables on which branchings have been performed in all ancestors if this is larger than the array size, arrays should be reallocated and method should be called again
branchvarssize	available slots in arrays

void SCIPnodeGetAncestorBranchingsPart	(	SCIP_NODE *	node,
		SCIP_NODE *	parent,
		SCIP_VAR **	branchvars,
		SCIP_Real *	branchbounds,
		SCIP_BOUNDTYPE *	boundtypes,
		int *	nbranchvars,
		int	branchvarssize
	)

returns the set of variable branchings that were performed between the given node and the given parent node.

Parameters

node	node data
parent	node data
branchvars	array of variables on which the branchings has been performed in all ancestors
branchbounds	array of bounds which the branchings in all ancestors set
boundtypes	array of boundtypes which the branchings in all ancestors set
nbranchvars	number of variables on which branchings have been performed in all ancestors if this is larger than the array size, arrays should be reallocated and method should be called again
branchvarssize	available slots in arrays

SCIP_RETCODE SCIPnodePrintAncestorBranchings	(	SCIP_NODE *	node,
		FILE *	file
	)

outputs the path into given file stream in GML format

Parameters

node	node data
file	file to output the path

void SCIPnodeGetAncestorBranchingPath	(	SCIP_NODE *	node,
		SCIP_VAR **	branchvars,
		SCIP_Real *	branchbounds,
		SCIP_BOUNDTYPE *	boundtypes,
		int *	nbranchvars,
		int	branchvarssize,
		int *	nodeswitches,
		int *	nnodes,
		int	nodeswitchsize
	)

returns the set of variable branchings that were performed in all ancestor nodes (nodes on the path to the root) to create this node sorted by the nodes, starting from the current node going up to the root

Parameters

node	node data
branchvars	array of variables on which the branchings has been performed in all ancestors
branchbounds	array of bounds which the branchings in all ancestors set
boundtypes	array of boundtypes which the branchings in all ancestors set
nbranchvars	number of variables on which branchings have been performed in all ancestors if this is larger than the array size, arrays should be reallocated and method should be called again
branchvarssize	available slots in arrays
nodeswitches	marks, where in the arrays the branching decisions of the next node on the path start; branchings performed at the parent of node always start at position 0. For single variable branching, nodeswitches[i] = i holds
nnodes	number of nodes in the nodeswitch array
nodeswitchsize	available slots in node switch array

SCIP_Bool SCIPnodesSharePath	(	SCIP_NODE *	node1,
		SCIP_NODE *	node2
	)

checks for two nodes whether they share the same root path, i.e., whether one is an ancestor of the other

Parameters

node1	node data
node2	node data

SCIP_NODE* SCIPnodesGetCommonAncestor	(	SCIP_NODE *	node1,
		SCIP_NODE *	node2
	)

finds the common ancestor node of two given nodes

Parameters

node1	node data
node2	node data

SCIP_NODETYPE SCIPnodeGetType

(

SCIP_NODE *

node

)

gets the type of the node

Parameters

node

node

SCIP_Longint SCIPnodeGetNumber

(

SCIP_NODE *

node

)

gets successively assigned number of the node

Parameters

node

node

int SCIPnodeGetDepth

(

SCIP_NODE *

node

)

gets the depth of the node

Parameters

node

node

SCIP_Real SCIPnodeGetLowerbound

(

SCIP_NODE *

node

)

gets the lower bound of the node

Parameters

node

node

SCIP_Real SCIPnodeGetEstimate

(

SCIP_NODE *

node

)

gets the estimated value of the best feasible solution in subtree of the node

Parameters

node

node

SCIP_REOPTTYPE SCIPnodeGetReopttype

(

SCIP_NODE *

node

)

gets the reoptimization type of a node

Parameters

node

node

unsigned int SCIPnodeGetReoptID

(

SCIP_NODE *

node

)

gets the unique id to identify the node during reoptimization; id is 0 if the node is the root or not part of the reoptimization tree

Parameters

node

node

void SCIPnodeSetReopttype	(	SCIP_NODE *	node,
		SCIP_REOPTTYPE	type
	)

sets the reoptimization type of the node

Parameters

node	node
type	reoptimization type

void SCIPnodeSetReoptID	(	SCIP_NODE *	node,
		unsigned int	id
	)

sets a unique id to identify the node during reoptimization

Parameters

node	node
id	unique id

void SCIPnodeGetNDomchg	(	SCIP_NODE *	node,
		int *	nbranchings,
		int *	nconsprop,
		int *	nprop
	)

counts the number of bound changes due to branching, constraint propagation, and propagation

Parameters

node	node
nbranchings	pointer to store number of branchings (or NULL if not needed)
nconsprop	pointer to store number of constraint propagations (or NULL if not needed)
nprop	pointer to store number of propagations (or NULL if not needed)

SCIP_DOMCHG* SCIPnodeGetDomchg

(

SCIP_NODE *

node

)

gets the domain change information of the node, i.e., the information about the differences in the variables domains to the parent node

Parameters

node

node

SCIP_NODE* SCIPnodeGetParent

(

SCIP_NODE *

node

)

gets the parent node of a node in the branch-and-bound tree, if any

Parameters

node

node

SCIP_Bool SCIPnodeIsActive

(

SCIP_NODE *

node

)

returns whether node is in the path to the current node

Parameters

node

node

SCIP_Bool SCIPnodeIsPropagatedAgain

(

SCIP_NODE *

node

)

returns whether the node is marked to be propagated again

Parameters

node

node data