#6637 closed enhancement (fixed)
standardize the interface to TransitiveIdeal and friends
Reported by:  nthiery  Owned by:  mhansen 

Priority:  major  Milestone:  sage6.3 
Component:  combinatorics  Keywords:  backtrack, enumerated set, transitive closure, days57 
Cc:  sagecombinat, hivert  Merged in:  
Authors:  Sébastien Labbé  Reviewers:  Travis Scrimshaw 
Report Upstream:  N/A  Work issues:  
Branch:  3191690 (Commits, GitHub, GitLab)  Commit:  
Dependencies:  #14052  Stopgaps: 
Description (last modified by )
 Implement a single entry point for recursively enumerated sets:
RecursivelyEnumeratedSet(seeds, successors, structure=..., enumeration=...)
where structure
takes values in the set [None, 'forest', 'graded', 'symmetric']
and enumeration
takes values in the set [None, 'depth', 'breadth', 'naive']
.
 Deprecate
TransitiveIdeal
,TransitiveIdealGraded
andSearchForest
as entry point.
TransitiveIdeal(succ, seeds)
keeps the same behavior as before and is now the same asRecursivelyEnumeratedSet(seeds, succ, structure=None, enumeration='naive')
.
TransitiveIdealGraded(succ, seeds, max_depth)
keeps the same behavior as before and is now the same asRecursivelyEnumeratedSet(seeds, succ, structure=None, enumeration='breadth', max_depth=max_depth)
.
Remarks:
 For now the code of
SearchForest
is still insage/combinat/backtrack.py
. It should be moved insage/sets/recursively_enumerated_set.pyx
. See #16351.
TransitiveIdeal
andTransitiveIealGraded
are used in the code ofsage/combinat
,sage/categories
andsage/groups
at least. These should be updated to useRecursivelyEnumeratedSet
for speed improvements and also to avoid issues explained in C below. See #16352.
 Note that there were some issues with
TransitiveIdeal
andTransitiveIdealGraded
, namely:
 Enumeration of
TransitiveIdeal
is claimed to be depth first search in the top level filebacktrack.py
, but in fact, it is neither breadth first neither depth first. It is what I call a naive search.  Enumeration of
TransitiveIdealGraded
is indeed breadth first as claimed but it does not make use of the graded hypothesis at all because it remembers every generated elements.
See my status report at SageDays57 for more info.
Attachments (1)
Change History (62)
comment:1 Changed 9 years ago by
 Report Upstream set to N/A
comment:2 Changed 9 years ago by
 Summary changed from Follow up on #6000: standardize the interface to TransitiveIdeal and friends to standardize the interface to TransitiveIdeal and friends
comment:3 Changed 9 years ago by
 Description modified (diff)
comment:4 Changed 9 years ago by
In a tentative to find good choices for name and so on, here is how I see this.
 Let X be a set.
 Let R be a binary relation on X, that is R is a subset of the cartesian product of X times X.
 Denote by xRy if x is Rrelated to y.
Now
 Let
seeds
be a subset of X.  Let
succ
be a callable python objectX > 2^X
such that xRy if and only if y is insucc(x)
.
We are interested in the subset S of X that can be generated from the seeds
using the succ
recursively. More precisely in the set
S = {y : x = x1 R x2 R x3 R ... R xn = y and x in
seeds
}.
Moreover, we are interested in the enumeration of S itself and we consider depthfirst and breadthfirst as different and both usefull.
Such a relation G = (X,R) can be seen as a directed graph. I think this remark is useful as it may provide some vocabulary. Indeed the set S is the connected components of the generators in the digraph G.
I see some different cases :
1. We do not know anything more about the relation. We need to save in memory all the known
objects to avoid duplicates. This is what is currently done in TransitiveIdeal
(depthfirst search) and (curiously) in TransitiveIdealGraded
(breadthfirst search) also.
2. The directed graph S is a forest with given seeds
. Equivalently, one may say that S do not contain cycle (oriented or not). This is what is currently done in SearchForest
.
3. The relation is graded. By graded here I mean what I thought TransitiveIdealGraded
was doing until I look more carefully at the doc and the code. More seriously, by graded I mean the following : for all (x1 in seeds) and (y1 in seeds),
if (x1 R x2 R ... R xn) and (y1 R y2 R ... R ym) and (xn=ym), then (n=m).
The relation is graded if all path from the origin to an element have the same length. In this case, we only need to save in memory the current level.
4. The relation is symmetric. If the relation is symmetric, we only need to keep in memory the last two level of depth. This is what I needed and coded this week. And this is why I started to look more carefully at the code in sage/combinat/backtrack.py
...
That is it for now!
comment:5 followups: ↓ 6 ↓ 7 ↓ 8 Changed 9 years ago by
I totally agree with the analysis!
I don't know yet what would be the best name for the argument provided by the user to describe the relation. Behind the scene we are definitely modelling relation. But what the user provide is not the relation but a function that computes the (out) neighbors for this relation. If at the end of the day we choose "TransitiveClosure?" as name for the main entry point, then "neighbors" would be consistent. If we go for "RecursiveSet?" (or RecursiveEnumeratedSet? or variant thereof) then "operators" would be consistent.
Cheers,
Nicolas
comment:6 in reply to: ↑ 5 Changed 9 years ago by
I think relation
would not be too bad for the name of the successor keyword and should be considered as well. In some sense, a binary relation is a function f: X > 2^X
and a function is a relation such that f(x)=1
for all x.
Possibilities for successor keyword :
succ
: suitable for non symmetric relation, currently used inTransitiveIdeal
andTransitiveIdealGraded
successors
operators
neighbors
: suitable vocabulary for symmetric relationchildren
: suitable vocabulary for non symmetric relation, currently used inSearchForest
.relatives
: suitable vocabulary for symmetric relation
Possibilities for generators keyword :
generators
gens
roots
seeds
comment:7 in reply to: ↑ 5 Changed 9 years ago by
If we go for RecursiveSet (or RecursiveEnumeratedSet or variant thereof)
I like RecursiveSet. Maybe RecursiveEnumeratedSet is more related to what we do but is also longer.
Some links:
comment:8 in reply to: ↑ 5 Changed 9 years ago by
I don't know yet what would be the best name for the argument provided by the user to describe the relation.
For the above 4 cases, I would suggest arguments like the following :
RecursiveSet(seeds, succ) RecursiveSet(seeds, succ, structure="forest") RecursiveSet(seeds, succ, structure="graded") RecursiveSet(seeds, succ, structure="symmetric")
Changed 9 years ago by
comment:9 Changed 9 years ago by
I just added a patch. It implements the RecursiveSet_symmetric
class and creates factory called RecursiveSet
. For now, RecursiveSet
returns either an instance of TransitiveIdeal
, SearchForest
or RecursiveSet_symmetric
. I started an empty class RecursiveSet_graded
. See examples inside the docstring of the class RecursiveSet
.
It is not ready for review, but comments are welcome to help me continue this work.
Actually, my questions are :
 How should I merge
RecursiveSet
withTransitiveIdeal
andSearchForest
?  Do we like this interface?
comment:10 Changed 9 years ago by
 Dependencies set to #14052
comment:11 Changed 8 years ago by
 Milestone changed from sage5.11 to sage5.12
comment:12 Changed 8 years ago by
 Milestone changed from sage6.1 to sage6.2
comment:13 Changed 8 years ago by
 Branch set to u/slabbe/6637
 Commit set to c2861f04a7250c3c72438adc50ccad8a43c22e54
New commits:
c2861f0  Some fixes to TransitiveIdeal and TransitiveIdealGraded, added RecursiveSet factory

comment:14 Changed 8 years ago by
 Commit changed from c2861f04a7250c3c72438adc50ccad8a43c22e54 to 5924b4637237d77d81a3577b2a6d86c23f96a86a
Branch pushed to git repo; I updated commit sha1. New commits:
5924b46  Cleaning RecursiveSet and subclasses

comment:15 Changed 8 years ago by
 Cc hivert added
comment:16 Changed 8 years ago by
 Commit changed from 5924b4637237d77d81a3577b2a6d86c23f96a86a to 29aebab4b5bc94f8bfc35c994edb35d90d70557b
Branch pushed to git repo; I updated commit sha1. New commits:
29aebab  now 100% coverage, seeds instead of gens

comment:17 Changed 8 years ago by
 Commit changed from 29aebab4b5bc94f8bfc35c994edb35d90d70557b to b363c547908004c908baff117a53ec2279cc6f1b
Branch pushed to git repo; I updated commit sha1. New commits:
b363c54  Cleaning documentation and reverting some changes to TransitiveIdeals

comment:18 Changed 8 years ago by
 Commit changed from b363c547908004c908baff117a53ec2279cc6f1b to b8108ae30f45fb6dedadda77b53e30f5bc5e37f6
Branch pushed to git repo; I updated commit sha1. New commits:
b8108ae  implemented depth search with stack and breadth search with queue

comment:19 Changed 8 years ago by
 Commit changed from b8108ae30f45fb6dedadda77b53e30f5bc5e37f6 to 9de2cf9ba5f22b83ab14827651f430292e727684
Branch pushed to git repo; I updated commit sha1. New commits:
9de2cf9  moving RecursivelyEnumerableSet to sage/sets

comment:20 Changed 8 years ago by
 Commit changed from 9de2cf9ba5f22b83ab14827651f430292e727684 to 5d634535fcee7fcba413170826b03011373505d1
Branch pushed to git repo; I updated commit sha1. New commits:
5d63453  doc fixes + adding Parent and category

comment:21 Changed 8 years ago by
 Description modified (diff)
 Status changed from new to needs_review
comment:22 Changed 8 years ago by
 Commit changed from 5d634535fcee7fcba413170826b03011373505d1 to 4934fa2967e5bb521167d34c15e3152b40f30e63
Branch pushed to git repo; I updated commit sha1. New commits:
4934fa2  deprecate import of TransitiveIdeal + level method for RecursivelyEnumeratedSet

comment:23 Changed 8 years ago by
 Commit changed from 4934fa2967e5bb521167d34c15e3152b40f30e63 to 94a4d7aaa77bfc48894d17d5242d324c3e798307
Branch pushed to git repo; I updated commit sha1. New commits:
94a4d7a  level > graded component, algorithm > enumeration, more docs, deprecated SearchForest also

comment:24 Changed 8 years ago by
 Commit changed from 94a4d7aaa77bfc48894d17d5242d324c3e798307 to 52ce4a357d72762caf3339fe0282a0364e15a842
Branch pushed to git repo; I updated commit sha1. New commits:
52ce4a3  succ > successors, fixed doctests in backtrack.py

comment:25 Changed 8 years ago by
I think I will stop now. The next thing to do would be to move code from sage/combinat/backtrack.py
to sage/sets/recursively_enumerated_set.py
more precisely, the SearchForest code. But since it is mostly about moving code (does not change any functionality), I suggest to do it in a another ticket and review/merge this ticket now.
Needs review!
Sébastien
comment:26 Changed 8 years ago by
 Keywords days57 added
comment:27 Changed 8 years ago by
 Milestone changed from sage6.2 to sage6.3
comment:28 followup: ↓ 29 Changed 8 years ago by
 Status changed from needs_review to needs_work
your commits remove completely combinat/all.py ....
comment:29 in reply to: ↑ 28 Changed 8 years ago by
Replying to chapoton:
your commits remove completely combinat/all.py ....
I see. It is strange because I can't see which commit did that... I will investigate.
comment:30 Changed 8 years ago by
I believe that's an error with the trac plugin (I've seen that before).
Can I make a feature request for this ticket, could we also cythonize this for speed (or at least make the new file a .pyx
file)?
comment:31 Changed 8 years ago by
Indeed, there is some gain. I did one example:
Python:
sage: f = lambda a: [a1,a+1] sage: C = RecursivelyEnumeratedSet([10, 15], f, structure='symmetric') sage: it = iter(C) sage: %time L = [next(it) for _ in xrange(10^6)] CPU times: user 5.82 s, sys: 239 ms, total: 6.06 s Wall time: 6.07 s
Cython:
sage: f = lambda a: [a1,a+1] sage: C = RecursivelyEnumeratedSet([10, 15], f, structure='symmetric') sage: it = iter(C) sage: %time L = [next(it) for _ in xrange(10^6)] CPU times: user 4.47 s, sys: 408 ms, total: 4.88 s Wall time: 4.89 s
comment:32 Changed 8 years ago by
 Commit changed from 52ce4a357d72762caf3339fe0282a0364e15a842 to 42262457c67606ba2861e9ba7b5cb6f20450f09d
comment:33 Changed 8 years ago by
 Description modified (diff)
comment:34 Changed 8 years ago by
 Description modified (diff)
I keep the status of the ticket to needs work because I realized that some doctest were broken in the sage library. I am working on it.
comment:35 Changed 8 years ago by
 Commit changed from 42262457c67606ba2861e9ba7b5cb6f20450f09d to 766a1b0d7a09c8d9597308592db9543145e61751
comment:36 Changed 8 years ago by
 Description modified (diff)
 Status changed from needs_work to needs_review
comment:37 Changed 8 years ago by
 Branch changed from u/slabbe/6637 to public/ticket/6637
 Commit changed from 766a1b0d7a09c8d9597308592db9543145e61751 to d8b942bf45c05f4df5fe093b0b63ac63e7127db6
 Reviewers set to Travis Scrimshaw
Some more speedup by doing some more cythonization. Before:
sage: f = lambda a: [a1,a+1] sage: C = RecursivelyEnumeratedSet([10, 15], f, structure='symmetric') sage: it = iter(C) sage: %time L = [next(it) for _ in xrange(10^6)] CPU times: user 9.68 s, sys: 147 ms, total: 9.83 s Wall time: 9.81 s
With my commit:
sage: f = lambda a: [a1,a+1] sage: C = RecursivelyEnumeratedSet([10, 15], f, structure='symmetric') sage: it = iter(C) sage: %time L = [next(it) for _ in xrange(10^6)] CPU times: user 8.02 s, sys: 103 ms, total: 8.13 s Wall time: 8.15 s
I'm sure I haven't done the best cythonization job on this, but it works and all tests pass. If you're happy with my changes, then positive review.
New commits:
0d592ce  Merge branch 'u/slabbe/6637' of trac.sagemath.org:sage into public/ticket/6637

f200525  More cythonization.

72f5bf6  Merge branch 'u/slabbe/6637' of trac.sagemath.org:sage into public/ticket/6637

df40815  Some tweaks in the cythonization.

e68a15f  Fixed pickling issue.

d8b942b  Some other potential cython speedups.

comment:38 Changed 8 years ago by
 Description modified (diff)
comment:39 Changed 8 years ago by
 Description modified (diff)
comment:40 Changed 8 years ago by
I do gain one more second with your improvements. Great!
sage: sage: f = lambda a: [a1,a+1] sage: sage: C = RecursivelyEnumeratedSet([10, 15], f, structure='symmetric') sage: sage: it = iter(C) sage: sage: %time L = [next(it) for _ in xrange(10^6)] CPU times: user 3.49 s, sys: 246 ms, total: 3.74 s Wall time: 3.79 s
I do not like factory function in general and was happy to use for the first time the metaclass stuff. But apparently, it is not as efficient? Did you check if only removing the metaclass stuff was giving a speedup?
comment:41 Changed 8 years ago by
 Commit changed from d8b942bf45c05f4df5fe093b0b63ac63e7127db6 to 3191690431cfe1614444004863b15a331941ad00
Branch pushed to git repo; I updated commit sha1. New commits:
3191690  Trac #6637: More deprecation doc in backtrack.py

comment:42 Changed 8 years ago by
Travis, did you check that the doc was building fine? I am not able to, I get :
$ sage docbuild reference/structure html [structure] WARNING: intersphinx inventory '/Users/slabbe/Applications/sagegit/src/doc/output/html/en/reference/quivers/objects.inv' not fetchable due to <type 'exceptions.IOError'>: [Errno 2] No such file or directory: '/Users/slabbe/Applications/sagegit/src/doc/output/html/en/reference/quivers/objects.inv' Error building the documentation. Note: incremental documentation builds sometimes cause spurious error messages. To be certain that these are real errors, run "make docclean" first and try again. Traceback (most recent call last): File "/Users/slabbe/Applications/sagegit/src/doc/common/builder.py", line 1477, in <module> getattr(get_builder(name), type)() File "/Users/slabbe/Applications/sagegit/src/doc/common/builder.py", line 699, in _wrapper getattr(DocBuilder, build_type)(self, *args, **kwds) File "/Users/slabbe/Applications/sagegit/src/doc/common/builder.py", line 94, in f execfile(sys.argv[0]) File "/Users/slabbe/Applications/sagegit/src/doc/common/customsphinxbuild.py", line 210, in <module> raise OSError(ERROR_MESSAGE) OSError: [structure] WARNING: intersphinx inventory '/Users/slabbe/Applications/sagegit/src/doc/output/html/en/reference/quivers/objects.inv' not fetchable due to <type 'exceptions.IOError'>: [Errno 2] No such file or directory: '/Users/slabbe/Applications/sagegit/src/doc/output/html/en/reference/quivers/objects.inv'
Once, I may confirm the docs does build fine. I will set this to positive review.
comment:43 Changed 8 years ago by
 Status changed from needs_review to positive_review
make docclean
fixed the error. Doc builds fine.
comment:44 Changed 8 years ago by
 Status changed from positive_review to needs_info
Sebastien wants to double check the Metaclass thingy.
comment:45 followup: ↓ 48 Changed 8 years ago by
As I recall, metaclasses are not supported in extension classes by Cython. The metaclass should not change the speed since it's only called/used upon object creation.
comment:46 followup: ↓ 47 Changed 8 years ago by
Also FTR, I liked your usage of the metaclass (and I can't check the doc until I get my docbuilder to actually work again... :/
).
comment:47 in reply to: ↑ 46 Changed 8 years ago by
If you agree Travis, I will try to put the metaclass use back in. Also, maybe Florent can say a word about it. He coached me on how to implement it.
comment:48 in reply to: ↑ 45 Changed 8 years ago by
Replying to tscrim:
As I recall, metaclasses are not supported in extension classes by Cython. The metaclass should not change the speed since it's only called/used upon object creation.
Ok, now I see what you mean. When the class is cdef
, then the __classcall_private__
do not get called instead of the __init__
:
sage: f = lambda a: [a1,a+1] sage: RecursivelyEnumeratedSet([0], f) A recursively enumerated set (depth first search) sage: RecursivelyEnumeratedSet([0], f, structure='symmetric') Traceback (most recent call last): ... TypeError: __init__() got an unexpected keyword argument 'structure'
I also saw in the doc that: "For a Cython class (not cdef since they doesn’t allows metaclasses)"
comment:49 Changed 8 years ago by
comment:50 Changed 8 years ago by
 Commit changed from 3191690431cfe1614444004863b15a331941ad00 to dd72bfc1227605362e9baf847a623ddd6bd297f9
comment:51 followup: ↓ 52 Changed 8 years ago by
Looking at your commit, I don't see any benefit in using the metaclass. However I'm not opposed to the renaming, so I've just pushed that.
comment:52 in reply to: ↑ 51 Changed 8 years ago by
Replying to tscrim:
Looking at your commit, I don't see any benefit in using the metaclass.
Yes exactly. I needed to play with it to understand what you meant.
However I'm not opposed to the renaming, so I've just pushed that.
Well, the renaming was just an easy way for me to check that sage t recursively_enumerated_set.pyx
was ok after I realised that __classcall_private__
was ignored by cdef
class. It was not a suggestion, but it would not be the first renamed function:
sage: import_statements(sum) from sage.misc.functional import symbolic_sum
So, we go with commit dd72bfc instead of 3191690 ?
comment:53 followup: ↓ 54 Changed 8 years ago by
 Status changed from needs_info to needs_review
If that's okay with you.
comment:54 in reply to: ↑ 53 Changed 8 years ago by
Replying to tscrim:
If that's okay with you.
The more I think about it, the less I like it. I think dd72bfc can be confusing for someone looking at the file for the first time. Until that person looks at the file sage/sets/all.py he will not understand how the __init__
handles the structure argument. And the key will always be hidden in some other file sage/sets/all.py
. I suggest we go with your initial factory function. More precisely with commit 3191690. Do you agree?
If so, I do not know what should we do then (git question). Should we update the commit field? Should we reset the HEAD of the branch? Should we create a new branch pointing to the commit?
comment:55 followup: ↓ 56 Changed 8 years ago by
Good point. What we'll do is create a new branch which just points to the old commit (afterwards we can delete our old branches). Do you want to do this or should I?
comment:56 in reply to: ↑ 55 Changed 8 years ago by
Let me try.
comment:57 Changed 8 years ago by
 Branch changed from public/ticket/6637 to public/ticket/6637a
 Commit changed from dd72bfc1227605362e9baf847a623ddd6bd297f9 to 3191690431cfe1614444004863b15a331941ad00
The following did the trick:
git checkout 3191690 b t/6637a
comment:58 Changed 8 years ago by
 Status changed from needs_review to positive_review
Then let's get this in. Thanks Sébastien.
comment:59 Changed 8 years ago by
Thanks for the review and cython improvements!
comment:60 Changed 8 years ago by
 Branch changed from public/ticket/6637a to 3191690431cfe1614444004863b15a331941ad00
 Resolution set to fixed
 Status changed from positive_review to closed
comment:61 Changed 8 years ago by
 Commit 3191690431cfe1614444004863b15a331941ad00 deleted
 Description modified (diff)
Here are some discussions related to this ticket: