File: subsets-doc.m2

package info (click to toggle)
macaulay2 1.25.05%2Bds-2
  • links: PTS, VCS
  • area: main
  • in suites: experimental
  • size: 172,152 kB
  • sloc: cpp: 107,824; ansic: 16,193; javascript: 4,189; makefile: 3,899; lisp: 702; yacc: 604; sh: 476; xml: 177; perl: 114; lex: 65; python: 33
file content (53 lines) | stat: -rw-r--r-- 1,346 bytes parent folder | download | duplicates (5)
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
42
43
44
45
46
47
48
49
50
51
52
53
-- Status: rewritten July 2018
-- Author: Lily Silverstein

doc///
 Key
  subsets
  (subsets, ZZ)
  (subsets, ZZ, ZZ)
  (subsets, List)
  (subsets, List, ZZ)
  (subsets, Sequence, ZZ)
  (subsets, Set)
  (subsets, Set, ZZ)
 Headline
  produce the subsets of a set or list
 Usage
  subsets(A)
  subsets(A, n)
 Inputs
  A: List
   , sequence, set or integer
  n: ZZ
   optional input to specify subsets of a particular size
 Outputs
  L: List
   of subsets (of size {\tt n} if given)
 Description
  Text
   If {\tt A} is an integer, {\tt subsets(A)} lists the subsets of {\tt \{0, 1, ..., A-1\}}.
  Example
   subsets(3)
   subsets(5, 3) 
  Text
   {\tt A} can be a list, sequence, or set. The elements need not be of the same type.
  Example
   subsets({"apple", "banana", {1,2,3}, 7.1}, 3)
  Text
   If a list contains repetitions, so will the subsets of that list. 
   Since a @TO Set@ has no repetitions, neither do its subsets. Also, 
   the subsets of a set will again be sets (while the subsets of a list are lists).
  Example
   subsets({"apple", "apple", "banana"})
   subsets(set{"apple", "apple", "banana"})
  Text
   The subsets of a Sequence are lists, not sequences. Also, a subset size {\bf must} be 
   specified when calling {\tt subsets} on a sequence.
 SeeAlso
  partition
  set
  sublists
  substring
  "lists and sequences"
///