1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
|
--- status: DRAFT
--- author(s): MES
--- notes:
document {
Key => {
partition,
(partition,Function,VisibleList),
(partition,Function,VisibleList,VisibleList),
(partition,Function,VirtualTally),
(partition,Function,VirtualTally,VisibleList)},
Headline => "partition a set or list by values of a function",
Usage => "partition(f,L)\npartition(f,L,I)",
Inputs => {
"f" => Function,
"L" => {ofClass VisibleList, ", or ", ofClass VirtualTally}
},
Outputs => {
HashTable => {"whose keys are the possible values of the function ", TT "f",
" on the elements of the list, set or tally ", TT "L",
", and the corresponding value of the hash table is the list, set or
tally of elements of ", TT "L", " which take that value under ", TT "f", ".
The optional third argument ", TT "I", " is a list whose elements will
be included as keys in the return value, allowing empty lists to appear
in the partition."}
},
EXAMPLE lines ///
L = {1,3,6,5,3,1,2,8,8,8}
partition(odd, L)
partition(odd, set L)
partition(odd, tally L)
partition (even, {3,3,5},{true,false})
///,
"The following example partitions the generators of an ideal by degree.",
EXAMPLE lines ///
R = QQ[a..f]
I = ideal"ab,ade,ac3,d4,b3,adf,f4,e10"
partition(f -> first degree f, flatten entries gens I)
///,
SeeAlso => {tally, partitions, sublists}
}
|
