analyzeEvolution {rPACI}

Analysis of repeated measures of the same patient over time

Description

Analyze the evolution of a patient over time. This function returns the Placido irregularity indices per time step and two temporal plots.

Usage

analyzeEvolution(data, fileExtension = "txt")

Arguments

data

Either 1) the path of a folder that contains corneal topography files, as exported by Placido disks corneal topographers, or 2) a list containing properly formatted data (loaded from a file using the function readFile, simulated using simulateData, or by other ways, as long as it meets the dataset requirements).

fileExtension

If data is a path, specify the file extension of the corneal topography files in the folder. It assumes all files with the given extension are corneal topography files of a single patient (by default, "txt").

Details

If the data are loaded from a folder, it will assume that the temporal arrangement is the alphabetical order of the filenames. Therefore, it is advised to use proper file names, for instance using this date format: 'YYYY-MM-DD.txt'.

Moreover, the folder should contain data measures of just one patient, since the function will read all the files (with the given extension) of the specified folder. On the other hand, if the data are stored in a list, it will be assumed that the temporal order corresponds with the index of the dataset in the list.

More details about supported file formats can be found in vignette("topographersDataFormat", package = "rPACI"), and about using rPACI in vignette("packageUsage", package = "rPACI").

Examples

# EXAMPLE 1
# Simulate the patient's measures over time
 dataT1 = simulateData(rings = 12, maximumMireDisplacement = 0.15, mireDisplacementAngle = 10)
 dataT2 = simulateData(rings = 12, maximumMireDisplacement = 0.15, mireDisplacementAngle = 45)
 dataT3 = simulateData(rings = 12, maximumMireDisplacement = 0.2, mireDisplacementAngle = 50)
 
# Create a list containing the data
data = list(
 dataT1 = dataT1,
 dataT2 = dataT2,
 dataT3 = dataT3
)

# Analyze the data over time
analyzeEvolution(data)

# EXAMPLE 2
# Specify a folder path to analyze a patient's evolution over time
analyzeEvolution(system.file("extdata/evolution/", package="rPACI"))