Open CunningGabe opened 2 years ago
The documentation here could use some work to improve clarity. For example:
GraphFromListOfEdges(list, list) Returns: IsGraph. Note this returns an undirected graph.
Given a list of vertices and a list of (directed) edges (represented as ordered pairs), this outputs the simple underlying graph with the appropriate vertex and directed-edge set.
Here we have a simple complete graph on 4 vertices
The inputs should be distinguishable, so you can tell which list goes with which clause in the description.
I was poking at these a bit... not sure how instructive this example is, but was a nice check on my work in this bug fix.
gap> etain0:=[[[1],0],[[2,3],0],[[4,5],0],[[6],0],[[7],0]];
[ [ [ 1 ], 0 ], [ [ 2, 3 ], 0 ], [ [ 4, 5 ], 0 ], [ [ 6 ], 0 ], [ [ 7 ], 0 ] ]
gap> etain1:=[[[1,2],1],[[3],1],[[4],1],[[5,6],1],[[7],1]];
[ [ [ 1, 2 ], 1 ], [ [ 3 ], 1 ], [ [ 4 ], 1 ], [ [ 5, 6 ], 1 ], [ [ 7 ], 1 ] ]
gap> etain2:=[[[1],2],[[2,4],2],[[3,5],2],[[6,7],2]];
[ [ [ 1 ], 2 ], [ [ 2, 4 ], 2 ], [ [ 3, 5 ], 2 ], [ [ 6, 7 ], 2 ] ]
gap> etain:=Union(etain0,etain1,etain2);
[ [ [ 1 ], 0 ], [ [ 1 ], 2 ], [ [ 1, 2 ], 1 ], [ [ 2, 3 ], 0 ], [ [ 2, 4 ], 2 ], [ [ 3 ], 1 ], [ [ 3, 5 ], 2 ], [ [ 4 ], 1 ],
[ [ 4, 5 ], 0 ], [ [ 5, 6 ], 1 ], [ [ 6 ], 0 ], [ [ 6, 7 ], 2 ], [ [ 7 ], 0 ], [ [ 7 ], 1 ] ]
gap> VoltageOperator(etain,"[r0,r2,id,id,id,r0,id,r1,id,id,r1,id,r1,r0]",Cube(3));
3-maniplex with 336 flags
gap> last=Lace(Cube(3));
true
gap> VoltageOperator(etain,"[r0,r2,id,id,id,r0,id,r1,id,id,r1,id,r1,r0]",Dodecahedron())=Lace(Dodecahedron());
true
I learned today that voltage graphs are sometimes called gain graphs. In fact, this is apparently super common. We should probably add suitable documentation and alternate method names to support this language (like SUPER common).
Do you know a paper you can point us to that would have names/notation we might need other than setting up the synonym GainGraph ?
No, but Klara would. I'll ask her.
From Klara:
There is a dynamical survey http://people.math.binghamton.edu/zaslav/Bsg/index.html