Detailed Description

interface for symmetry computations to sassy as a preprocessor to nauty

Author: Marc Pfetsch; Gioni Mexi; Christopher Hojny

Definition in file compute_symmetry_sassy_nauty.cpp.

#include "build_sassy_graph.h"
#include "compute_symmetry.h"
#include "nauty/nauty.h"
#include "nauty/nausparse.h"
#include <sassy/preprocessor.h>
#include "sassy/tools/nauty_converter.h"
#include "scip/expr_var.h"
#include "scip/expr_sum.h"
#include "scip/expr_pow.h"
#include "scip/expr.h"
#include "scip/cons_nonlinear.h"
#include "scip/cons_linear.h"
#include "scip/scip_mem.h"
#include "scip/symmetry_graph.h"

Go to the source code of this file.

Data Structures
struct	SYMMETRY_Data

struct	NAUTY_Data

Macros
#define	NAUTY

#define	STR(x) #x

#define	XSTR(x) STR(x)

Functions
static void	sassyhook (void user_param, int n, const int aut, int nsupp, const int *suppa)

static void	nautyterminationhook (graph g, int lab, int *ptn, int level, int numcells, int tc, int code, int m, int n)

SCIP_Bool	SYMcanComputeSymmetry (void)

const char *	SYMsymmetryGetName (void)

const char *	SYMsymmetryGetDesc (void)

const char *	SYMsymmetryGetAddName (void)

const char *	SYMsymmetryGetAddDesc (void)

static SCIP_RETCODE	computeAutomorphisms (SCIP scip, SYM_SYMTYPE symtype, sassy::static_graph G, int nsymvars, int maxgenerators, int **perms, int nperms, int nmaxperms, SCIP_Real log10groupsize, SCIP_Bool restricttovars, SCIP_Real *symcodetime, SCIP_Bool canterminateearly)

SCIP_RETCODE	SYMcomputeSymmetryGenerators (SCIP scip, int maxgenerators, SYM_GRAPH symgraph, int nperms, int nmaxperms, int **perms, SCIP_Real log10groupsize, SCIP_Real *symcodetime)

SCIP_Bool	SYMcheckGraphsAreIdentical (SCIP scip, SYM_SYMTYPE symtype, SYM_GRAPH G1, SYM_GRAPH *G2)

Variables
static struct NAUTY_Data	nautydata_

static TLS_ATTR char	nautyname [20]

Macro Definition Documentation

◆ NAUTY

#define NAUTY

Definition at line 38 of file compute_symmetry_sassy_nauty.cpp.

◆ STR

#define STR ( x ) #x

Definition at line 287 of file compute_symmetry_sassy_nauty.cpp.

◆ XSTR

#define XSTR ( x ) STR(x)

Definition at line 288 of file compute_symmetry_sassy_nauty.cpp.

Function Documentation

◆ sassyhook()

static void sassyhook	(	void *	user_param,
		int	n,
		const int *	aut,
		int	nsupp,
		const int *	suppa
	)

static

callback function for sassy

Parameters

user_param	parameter supplied at call to sassy
n	dimension of permutations
aut	permutation
nsupp	support size
suppa	support list

Definition at line 124 of file compute_symmetry_sassy_nauty.cpp.

References SYMMETRY_Data::maxgenerators, SYMMETRY_Data::nmaxperms, SYMMETRY_Data::nperms, SYMMETRY_Data::npermvars, NULL, SYMMETRY_Data::perms, SYMMETRY_Data::restricttovars, SYMMETRY_Data::scip, SCIP_OKAY, SCIPallocBlockMemoryArray, SCIPcalcMemGrowSize(), SCIPreallocBlockMemoryArray, SYM_SYMTYPE_PERM, SYM_SYMTYPE_SIGNPERM, and SYMMETRY_Data::symtype.

Referenced by computeAutomorphisms().

◆ nautyterminationhook()

static void nautyterminationhook	(	graph *	g,
		int *	lab,
		int *	ptn,
		int	level,
		int	numcells,
		int	tc,
		int	code,
		int	m,
		int	n
	)

static

callback function for nauty to terminate early

Parameters

g	sparse graph for nauty
lab	labels of node
ptn	array indicating change of set in node parition of graph
level	level of current node in nauty's tree
numcells	number of cells in current partition
tc	index of target cells in lab if children need to be explored
code	code produced by refinement and vertex-invariant procedures
m	number of edges in the graph
n	number of nodes in the graph

Definition at line 210 of file compute_symmetry_sassy_nauty.cpp.

References FALSE, NAUTY_Data::maxncells, NAUTY_Data::maxnnodes, nautydata_, NAUTY_Data::ntreenodes, NULL, NAUTY_Data::scip, SCIP_Bool, SCIP_VERBLEVEL_MINIMAL, SCIPverbMessage(), and TRUE.

Referenced by computeAutomorphisms().

◆ SYMcanComputeSymmetry()

SCIP_Bool SYMcanComputeSymmetry ( void )

return whether symmetry can be computed

Definition at line 257 of file compute_symmetry_sassy_nauty.cpp.

References TRUE.

Referenced by determineSymmetry(), and SCIPincludePropSymmetry().

◆ SYMsymmetryGetName()

const char * SYMsymmetryGetName ( void )

return name of external program used to compute generators

Definition at line 266 of file compute_symmetry_sassy_nauty.cpp.

References nautyname, and SCIPsnprintf().

Referenced by SCIPincludePropSymmetry().

◆ SYMsymmetryGetDesc()

const char * SYMsymmetryGetDesc ( void )

return description of external program used to compute generators

Definition at line 278 of file compute_symmetry_sassy_nauty.cpp.

Referenced by SCIPincludePropSymmetry().

◆ SYMsymmetryGetAddName()

const char * SYMsymmetryGetAddName ( void )

return name of additional external program used for computing symmetries

Definition at line 291 of file compute_symmetry_sassy_nauty.cpp.

References NULL, and XSTR.

Referenced by SCIPincludePropSymmetry().

◆ SYMsymmetryGetAddDesc()

const char * SYMsymmetryGetAddDesc ( void )

return description of additional external program used to compute symmetries

Definition at line 297 of file compute_symmetry_sassy_nauty.cpp.

References NULL.

Referenced by SCIPincludePropSymmetry().

◆ computeAutomorphisms()

static SCIP_RETCODE computeAutomorphisms	(	SCIP *	scip,
		SYM_SYMTYPE	symtype,
		sassy::static_graph *	G,
		int	nsymvars,
		int	maxgenerators,
		int ***	perms,
		int *	nperms,
		int *	nmaxperms,
		SCIP_Real *	log10groupsize,
		SCIP_Bool	restricttovars,
		SCIP_Real *	symcodetime,
		SCIP_Bool	canterminateearly
	)

static

computes autormorphisms of a graph

Parameters

scip	SCIP pointer
symtype	type of symmetries that need to be computed
G	pointer to graph for that automorphisms are computed
nsymvars	number of variables encoded in graph
maxgenerators	maximum number of generators to be constructed (=0 if unlimited)
perms	pointer to store generators as (nperms x npermvars) matrix
nperms	pointer to store number of permutations
nmaxperms	pointer to store maximal number of permutations (needed for freeing storage)
log10groupsize	pointer to store log10 of size of group
restricttovars	whether permutations shall be restricted to variables
symcodetime	pointer to store the time for symmetry code
canterminateearly	whether we allow to interrupt symmetry detection early (e.g., because of iteration limits)

Definition at line 304 of file compute_symmetry_sassy_nauty.cpp.

References FALSE, NAUTY_Data::maxgenerators, SYMMETRY_Data::maxgenerators, NAUTY_Data::maxncells, NAUTY_Data::maxnnodes, nautydata_, nautyterminationhook(), NAUTY_Data::nmaxperms, SYMMETRY_Data::nmaxperms, NAUTY_Data::nperms, SYMMETRY_Data::nperms, SYMMETRY_Data::npermvars, NAUTY_Data::ntreenodes, NULL, NAUTY_Data::perms, SYMMETRY_Data::perms, SYMMETRY_Data::restricttovars, sassyhook(), NAUTY_Data::scip, SYMMETRY_Data::scip, SCIP_CALL, SCIP_OKAY, SCIP_Real, SCIPgetIntParam(), SCIPgetSolvingTime(), and SYMMETRY_Data::symtype.

Referenced by SYMcheckGraphsAreIdentical(), and SYMcomputeSymmetryGenerators().

◆ SYMcomputeSymmetryGenerators()

SCIP_RETCODE SYMcomputeSymmetryGenerators	(	SCIP *	scip,
		int	maxgenerators,
		SYM_GRAPH *	symgraph,
		int *	nperms,
		int *	nmaxperms,
		int ***	perms,
		SCIP_Real *	log10groupsize,
		SCIP_Real *	symcodetime
	)

compute generators of symmetry group

Parameters

scip	SCIP pointer
maxgenerators	maximal number of generators constructed (= 0 if unlimited)
symgraph	symmetry detection graph
nperms	pointer to store number of permutations
nmaxperms	pointer to store maximal number of permutations (needed for freeing storage)
perms	pointer to store permutation generators as (nperms x npermvars) matrix
log10groupsize	pointer to store log10 of size of group
symcodetime	pointer to store the time for symmetry code