create.label {SIAMCAT} | R Documentation

## create a label object from metadata or an atomic vector

### Description

This function creates a label object from metadata or an atomic vector

### Usage

    create.label(label, case,
        meta=NULL, control=NULL,
        p.lab = NULL, n.lab = NULL,
        remove.meta.column=FALSE,
        verbose=1)

### Arguments

`label` | named vector to create the label or the name of the metadata column that will be used to create the label
`case` | name of the group that will be used as a positive label. If the variable is binary, the other label will be used as a negative one. If the variable has multiple values, all the other values will be used a negative label (testing one vs rest).
`meta` | metadata dataframe object or an object of class sample_data-class
`control` | name of a label or vector with names that will be used as a negative label. All values that are nor equal to case and control will be dropped. Default to NULL in which case: If the variable is binary, the value not equal to case will be used as negative. If the variable has multiple values, all the values not equal to cases will be used a negative label (testing one vs rest).
`p.lab` | name of the positive group (useful mostly for visualizations). Default to NULL in which case the value of the positive group will be used.
`n.lab` | name of the negative group (useful mostly for visualizations). Default to NULL in which case the value of the negative group will be used for binary variables and "rest" will be used for variables with multiple values.
`remove.meta.column` | boolean indicating if the label column in the metadata should be retained. Please note that if this is set to `TRUE`, the function will return a list as result. Defaults to `FALSE`
`verbose` | control output: `0` for no output at all, `1` for only information about progress and success, `2` for normal level of information and `3` for full debug information, defaults to `1`

### Value

an object of class label-class OR a list with entries `meta` and `label`, if `remove.meta.column` is set to `TRUE`

### Examples

        data('meta_crc_zeller')
        label <- create.label(label='Group', case='CRC', meta=meta.crc.zeller)

[Package SIAMCAT version 1.2.1 Index]