WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

RulesTree
Copy to clipboard.
✖
RulesTree

[Experimental]

Copy to clipboard.
✖
RulesTree[data{rule1,rule2,…}]

gives a tree whose root contains data and that has children specified by the rulei.

Details and Options

  • RulesTree gives a Tree object.
  • The children of RulesTree[data{rule1,rule2,…}] are given by the list {RulesTree[rule1],RulesTree[rule2],…}.
  • The children of RulesTree[data<|key1rule1,key2rule2,…|>] are given by the association <|key1RulesTree[rule1],key2RulesTree[rules2],…|>.
  • RulesTree[data] for data not of the form …{…}, …<|…|> or …None is equivalent to RulesTree[dataNone]. »
  • RulesTree takes the same options as Tree.

Examples

open allclose all

Basic Examples  (3)Summary of the most common use cases

Construct a tree with three leaves:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-by4nss
Direct link to example
Out[1]=1

Construct a tree with several levels:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-bnyksz
Direct link to example
Out[1]=1

Construct a tree with named edges:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-dp54us
Direct link to example
Out[1]=1

Scope  (4)Survey of the scope of standard use cases

Construct a leaf with no child:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-ehthw0
Direct link to example
Out[1]=1

Construct an inner node with no children:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-imf82i
Direct link to example
Out[1]=1
Copy to clipboard.
In[2]:=2
✖
https://wolfram.com/xid/0cg49mzfw-lsrqz6
Direct link to example
Out[2]=2

Specify a list of children:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-kj42p9
Direct link to example
Out[1]=1

Specify an association of children:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-8hbu8x
Direct link to example
Out[1]=1

Options  (9)Common values & functionality for each option

Styling Individual Tree Elements  (2)

Specify the label for the generated tree element:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-xl5r69
Direct link to example
Out[1]=1

Specify labels and styles for subtrees by position:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-x143u1
Direct link to example
Out[1]=1

Styling Entire Tree  (4)

Specify labels and styles for all subtrees:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-corr7
Direct link to example
Out[1]=1

Specify the base style:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-xdirf9
Direct link to example
Out[1]=1

Specify the styles for both the edges and the edges of the tree elements:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-s5hou5
Direct link to example
Out[1]=1

Specify the base style and styles for individual tree elements:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-ifl4r4
Direct link to example
Out[1]=1

Tree Layout and Graphics Options  (3)

Specify the orientation for the root:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-dis7x2
Direct link to example
Out[1]=1

Specify a named embedding:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-i8q32r
Direct link to example
Out[1]=1

Specify Graphics options:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-dbhiu5
Direct link to example
Out[1]=1

Applications  (1)Sample problems that can be solved with this function

Construct a tree of the House of Atreus:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-0bbxjt
Direct link to example
Out[1]=1

Properties & Relations  (2)Properties of the function, and connections to other functions

RulesTree constructs a tree associated with the given rules:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-k5b8dz
Direct link to example
Out[1]=1

Use TreeRules on the result to recover the original rules:

Copy to clipboard.
In[2]:=2
✖
https://wolfram.com/xid/0cg49mzfw-1xgvfd
Direct link to example
Out[2]=2

RulesTree can be computed with NestTree:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-5bkfq
Direct link to example
Copy to clipboard.
In[2]:=2
✖
https://wolfram.com/xid/0cg49mzfw-c7ramd
Direct link to example
Copy to clipboard.
In[3]:=3
✖
https://wolfram.com/xid/0cg49mzfw-3kqsjo
Direct link to example
Out[3]=3
Copy to clipboard.
In[4]:=4
✖
https://wolfram.com/xid/0cg49mzfw-q0zg48
Direct link to example
Out[4]=4

Possible Issues  (1)Common pitfalls and unexpected behavior

RulesTree[exprNone] is generally equivalent to RulesTree[expr]:

Copy to clipboard.
In[1]:=1
✖
https://wolfram.com/xid/0cg49mzfw-noy2dk
Direct link to example
Out[1]=1
Copy to clipboard.
In[2]:=2
✖
https://wolfram.com/xid/0cg49mzfw-g9mc1h
Direct link to example
Out[2]=2

However, the None is necessary to specify a tree with data of the form lhs{e1,e2,…} or lhsNone:

Copy to clipboard.
In[3]:=3
✖
https://wolfram.com/xid/0cg49mzfw-mzap99
Direct link to example
Out[3]=3

Without the None, this would be treated as a tree whose root contains lhs with children {RulesTree[e1],RulesTree[e2],…}:

Copy to clipboard.
In[4]:=4
✖
https://wolfram.com/xid/0cg49mzfw-lvbte4
Direct link to example
Out[4]=4
Wolfram Research (2021), RulesTree, Wolfram Language function, https://reference.wolfram.com/language/ref/RulesTree.html (updated 2022).
Copy to clipboard.
✖
Wolfram Research (2021), RulesTree, Wolfram Language function, https://reference.wolfram.com/language/ref/RulesTree.html (updated 2022).

Text

Wolfram Research (2021), RulesTree, Wolfram Language function, https://reference.wolfram.com/language/ref/RulesTree.html (updated 2022).

Copy to clipboard.
✖
Wolfram Research (2021), RulesTree, Wolfram Language function, https://reference.wolfram.com/language/ref/RulesTree.html (updated 2022).

CMS

Wolfram Language. 2021. "RulesTree." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2022. https://reference.wolfram.com/language/ref/RulesTree.html.

Copy to clipboard.
✖
Wolfram Language. 2021. "RulesTree." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2022. https://reference.wolfram.com/language/ref/RulesTree.html.

APA

Wolfram Language. (2021). RulesTree. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/RulesTree.html

Copy to clipboard.
✖
Wolfram Language. (2021). RulesTree. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/RulesTree.html

BibTeX

@misc{reference.wolfram_2025_rulestree, author="Wolfram Research", title="{RulesTree}", year="2022", howpublished="\url{https://reference.wolfram.com/language/ref/RulesTree.html}", note=[Accessed: 26-March-2025 ]}

Copy to clipboard.
✖
@misc{reference.wolfram_2025_rulestree, author="Wolfram Research", title="{RulesTree}", year="2022", howpublished="\url{https://reference.wolfram.com/language/ref/RulesTree.html}", note=[Accessed: 26-March-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_rulestree, organization={Wolfram Research}, title={RulesTree}, year={2022}, url={https://reference.wolfram.com/language/ref/RulesTree.html}, note=[Accessed: 26-March-2025 ]}

Copy to clipboard.
✖
@online{reference.wolfram_2025_rulestree, organization={Wolfram Research}, title={RulesTree}, year={2022}, url={https://reference.wolfram.com/language/ref/RulesTree.html}, note=[Accessed: 26-March-2025 ]}