summary.medic {tame}

Summary of medic object

Description

Make cluster characterizing summaries.

Usage

## S3 method for class 'medic'
summary(
  object,
  only = NULL,
  clusters = NULL,
  outputs = c("frequencies", "medications", "amounts", "trajectories", "interactions"),
  additional_data = NULL,
  ...
)

## S3 method for class 'summary.medic'
print(x, ...)

## S3 method for class 'summary.medic'
plot(x, by, facet, ...)

Arguments

object

An object for which a summary is desired.

only

<data-masking> Expressions that return a logical value, and are defined in terms of the variables in object and/or additional_data.

The default NULL selects all clusterings in object.

clusters

<tidy-select> An unquoted expression naming the cluster or clusters in object one wants to see summaries of. Names can be used as if they were positions in the data frame, so expressions like I:IV can be used to select a range of clusters.

The default NULL selects all clusters in the chosen clusterings of object.

outputs

A character vector naming the desired characteristics to output. The default names all possible output types.

additional_data

A data frame with additional data that may be (left-)joined onto the parameters in object. This is often used in conjuction with only to select specific clusterings based on additional_data.

...

Additional arguments passed to the internal summary function.

• cluster_wise an option in the medications() function.

• m an option in the medications() function. A numeric restricting the number of distinct ATC codes plotted within each cluster. That is, the (at most) m most frequent ATC codes within that cluster is given a color.

• q an option in the medications() function. A numeric between 0 and 1 restricting the minimal ATC codes frequency displayed within each cluster.

• count_grouper an option in the amounts() function. A function for grouping counts. As a standard it groups counts as 1 medication, 2 medications, and 3+ medications.

• atc_groups A data.frame specifying the ATC groups to summaries by. The data.frame must have two columns: (1) regex giving regular expressions specifying the wanted ATC groups and (2) atc_groups the name of this ATC grouping. As a standard the anatomical level (first level) of the ATC codes is used.

x

A summary.medic object for printing or plotting.

by

<data-masking>

facet

<data-masking>

Value

A list of clustering characteristics of class summary.medic is returned. It can contain any of the following characteristics:

Frequencies

The number of individuals assigned to each cluster and the associated frequency of assignment.

Medications

The number of individuals with a specific ATC code within a cluster. Moreover, it calculates the percentage of people with this medication assigned to this cluster and the percent of people within the cluster with this medication.

Amounts

The number of ATC codes an individual has, and then outputs the number of individuals within a cluster that has that many ATC codes. Moreover, various relevant percentages or calculated. See Value below for more details on these percentages.

Trajectories

The number of unique timing trajectories in each cluster, and the average timing trajectories in each cluster.

Interactions

The number of people with unique timing trajectory and ATC group, as given by atc_groups, in each cluster.

Methods (by generic)

• print(summary.medic): Print method for medic-objects

• plot(summary.medic): Plot method for medic-objects

Examples

clust <- medic(complications, id = id, atc = atc, k = 3:5)