MakeMorphMatrix: Creates a morphological data file from a matrix

Description

Creates a morphological data file from a character-taxon matrix.

Usage

MakeMorphMatrix(CharacterTaxonMatrix, header = "", Weights = NULL,
  ordering = NULL, symbols = NULL, equalise.weights = FALSE,
  ignore.duplicate.taxa = FALSE)

Arguments

CharacterTaxonMatrix

A Character-Taxon (columns-rows) matrix, with taxon names as rownames.

header

A scalar indicating any header text (defaults to an empty string: "").

Weights

A vector specifying the weights used (if not specified defaults to 1).

ordering

A vector indicating whether characters are ordered ("ord") or unordered ("unord") (if no specified defaults to ordered).

symbols

The symbols to use if writing to a file (defaults to the numbers 0:9 then the letters A to V).

equalise.weights

Optional that overrides the weights specified above make all characters truly equally weighted.

ignore.duplicate.taxa

Logical indicating whether or not to ignore (allow; TRUE) duplicate taxa or not (FALSE; default).

Value

Topper

Contains any header text or step matrices and pertains to the entire file.

Matrix_N

One or more matrix blocks (numbered 1 to N) with associated information pertaining only to that matrix block. This includes the block name (if specificed, NA if not), the block datatype (one of "CONTINUOUS", "DNA", "NUCLEOTIDE", "PROTEIN", "RESTRICTION", "RNA", or "STANDARD"), the actual matrix (taxa as rows, names stored as rownames and characters as columns), the ordering type of each character ("ord" = ordered, "unord" = unordered), the character weights, the minimum and maximum values (used by Claddis' distance functions), and the original characters (symbols, missing, and gap values) used for writing out the data.

Details

Claddis generally assumes that matrices will be imported into R from the #NEXUS format, but in some cases (e.g., when using simulated data) it might be desirable to build a matrix within R. This function allows the user to convert such a matrix into the format required by other Claddis functions as long as it only contains a single block.

NB: Currently the function cannot deal directly with step matrices or continuous characters.

Examples

Run this code

# NOT RUN {
# Create random 10-by-50 matrix:
CharacterTaxonMatrix <- matrix(sample(c("0", "1", "0&1", NA, ""),
  500, replace = TRUE), nrow = 10, dimnames =
  list(apply(matrix(sample(LETTERS, 40,
  replace = TRUE), nrow = 10), 1, paste,
  collapse = ""), c()))

# Reformat for use elsewhere in Claddis:
MakeMorphMatrix(CharacterTaxonMatrix)

# }