Module:Sandbox/Jts1882/CladeN/doc

From blackwiki
< Module:Sandbox‎ | Jts1882/CladeN
Revision as of 15:53, 7 November 2019 by blackwiki>Jts1882 (update and add addition table for grouplabel (not yet modified) →‎Technical background)
Jump to navigation Jump to search

This is the documentation page for Module:Sandbox/Jts1882/CladeN

Script error: No such module "Uses TemplateStyles".

This module is designed to be used with the CladeN template to draw phylogenetic trees or cladograms. The new template-module combination extends the feature available with the clade and cladex templates. As it replicates the behaviour of the clade and cladex templates it should be suitable for replacing them.

Additionally, the module as the code for a prototype [User:Jts1882/sandbox/templates/NewickConverter|NewickConverter] template, which converts Newick strings into clade structure. This is not to be used in wikipedia articles, but is a utility to help construct cladograms for inclusion in articles.

Usage

{{#invoke:Sandbox/Jts1882/CladeN|main|style={{{style}}}}}

Examples

Simple examples mimicking the clade template:

Example demonstrating more advanced features of cladeN:

Example demonstrating features available:

User:Jts1882/sandbox/test/Newick tree

Technical background

The clade template has many features for customising the appearance. Using them optimally requires some understanding of how the template works. The cladogram is a table and the lines of the cladogram are borders of the cells.

Description Table cell structure Cladogram Code using clade template

A simple clade structure with a single child node (or leaf).

This is an HTML table with two rows and two columns. The upper and lower cells in the left column hold the labels provided by |label= and |sublabel= parameters, respectively. The the cells of the righthand column are merged using the rowspan attribute.

labelA

Leaf A

sublabelA
labelA

LeafA

sublabelA
{{cladeN |thickness=3
|label1=labelA
|sublabel1=sublabelA
|1=LeafA
}}

To build the cladogram, a the text in LeafA can be replaced with another clade structure.

Hence a second HTML table is placed inside a the right-hand cell of the outer table.

labelA
label1 leaf1
sublabel1
label2 leaf2
sublabel2
sublabelA
labelA
label1

leaf1

sublabel1
label2

leaf2

sublabel2
sublabelA
{{cladeN |thickness=3
|label1=labelA
|sublabel1=sublabelA
|1={{cladeN |thickness=3
   |label1=label1
   |sublabel1=sublabel1
   |1=leaf1
   |label2=label2
   |sublabel2=sublabel2
   |2=leaf2
   }}
}}

Add right hand labels with grouplabel

Description Table cell structure Cladogram Code using clade template

A simple clade structure with a single child node (or leaf).

This is an HTML table with two rows and two columns. The upper and lower cells in the left column hold the labels provided by |label= and |sublabel= parameters, respectively. The the cells of the righthand column are merged using the rowspan attribute.

labelA

Leaf A

sublabelA
labelA

LeafA

sublabelA
{{cladeN |thickness=3
|label1=labelA
|sublabel1=sublabelA
|1=LeafA
}}

To build the cladogram, a the text in LeafA can be replaced with another clade structure.

Hence a second HTML table is placed inside a the right-hand cell of the outer table.

labelA
label1 leaf1
sublabel1
label2 leaf2
sublabel2
sublabelA
labelA
label1

leaf1

sublabel1
label2

leaf2

sublabel2
sublabelA
{{cladeN |thickness=3
|label1=labelA
|sublabel1=sublabelA
|1={{cladeN |thickness=3
   |label1=label1
   |sublabel1=sublabel1
   |1=leaf1
   |label2=label2
   |sublabel2=sublabel2
   |2=leaf2
   }}
}}