Type: | Package |
Title: | Miscellaneous Functions |
Version: | 0.1.0 |
Maintainer: | Yoo Ri Hwang <yrhwang89@gmail.com> |
Description: | The Author's personal R Package that contains miscellaneous functions. The current version of package contains miscellaneous functions for brain data to compute Asymmetry Index (AI) and bilateral (L+R) measures and reshape the data. |
License: | GPL-2 | GPL-3 [expanded from: GPL (≥ 2)] |
Encoding: | UTF-8 |
LazyData: | true |
Depends: | R (≥ 3.5.0) |
RoxygenNote: | 7.2.3 |
Suggests: | testthat (≥ 3.0.0) |
Config/testthat/edition: | 3 |
Imports: | stats |
NeedsCompilation: | no |
Packaged: | 2023-10-17 02:42:39 UTC; user |
Author: | Yoo Ri Hwang [aut, cre] |
Repository: | CRAN |
Date/Publication: | 2023-10-18 14:00:06 UTC |
The brain asymmetry index (AI)
Description
AI formula = [(left-right)/(left+right)]. compute_AI() creates new columns that are AIs of the brain measures using the most widely-used formula.
Usage
compute_AI(
data = sample_data,
left_hemisphere = "lh",
right_hemisphere = "rh",
separator = "_",
ID = "ID",
hemisphere = "prefix",
start,
end
)
Arguments
data |
The wide format data |
left_hemisphere |
The prefix or suffix that indicates the left hemisphere in the variable names |
right_hemisphere |
The prefix or suffix string that indicates the right hemisphere in the variable names |
separator |
A character vector that separates characters in the variable names. |
ID |
The column of identifiers. |
hemisphere |
The character vector that indicates whether a hemisphere indicator in the variable names is a prefix or suffix. |
start |
The column that specifies the starting point of a set of variables to calculate the AIs. |
end |
The column that specifies the endpoint of a set of variables to calculate the AIs. |
Value
The data with AIs.
Examples
data(sample_data)
compute_AI(sample_data,
left_hemisphere = "lh",
right_hemisphere = "rh",
separator="_",
ID="ID",
hemisphere="prefix",
start="lh_Thalamus",
end="rh_AccumbensArea")
the bilateral (Left + Right) measures.
Description
compute_total() creates new columns that are the bilateral (Left + Right) measures.
Usage
compute_total(
data = sample_data,
left_hemisphere = "lh",
right_hemisphere = "rh",
separator = "_",
ID = "ID",
hemisphere = "prefix",
start,
end
)
Arguments
data |
The wide format data |
left_hemisphere |
The prefix or suffix that indicates the left hemisphere in the variable names |
right_hemisphere |
The prefix or suffix string that indicate the right hemisphere in the variable names |
separator |
A character vector that separates characters in the variable names. |
ID |
The column of identifiers. |
hemisphere |
The character vector that indicates whether a hemisphere indicator in the variable names is a prefix or suffix. |
start |
The column that specifies the starting point of a set of variables to calculate the bilateral (L+R) measures. |
end |
The column that specifies the endpoint of a set of variables to calculate the bilateral (L+R) measures. |
Value
The data with the bilateral (L+R) measures.
Examples
data(sample_data)
compute_total(sample_data,
left_hemisphere="lh",
right_hemisphere="rh",
separator="_",
ID="ID",
hemisphere="prefix",
start="lh_Thalamus",
end="rh_AccumbensArea")
Long Format Sample Data
Description
Long Format Sample Data
Usage
long
Format
A long format data frame.
The regional brain measures from left and right hemisphere, attention check, and ID
Reshapes the data
Description
long2wide() is data-reshaping function for long format data. This function mainly targets the brain structure data that contains the data from the left and right hemispheres
Usage
long2wide(data, ID = "ID", separator = "_", hemisphere = "prefix", start, end)
Arguments
data |
The long format data. |
ID |
The column of identifiers. |
separator |
A character vector that separates characters in the variable names. |
hemisphere |
The character vector that indicates whether a hemisphere indicator in the variable names is the prefix or suffix. At this point, only a "prefix" option is available. |
start |
The column that specifies the starting point of a set of variables to be reshaped. |
end |
The column that specifies the endpoint of a set of variables to be reshaped. |
Value
The wide format data
Examples
data(long)
long2wide(
data=long,
ID="ID",
separator="_",
hemisphere="prefix",
start="region",
end="rh")
Wide Format Sample Data
Description
Wide Format Sample Data
Usage
sample_data
Format
A wide format data frame.
The regional brain measures from left and right hemisphere, attention check, and ID.
Reshapes the data
Description
wide2long() function is data-reshaping function for wide format data. This function mainly targets the brain structure data that contains the data from the left and right hemispheres
Usage
wide2long(data, ID = "ID", separator = "_", hemisphere = "prefix", start, end)
Arguments
data |
The wide format data. |
ID |
The column of identifiers. |
separator |
A character vector that separates characters in the variable names. |
hemisphere |
Whether a hemisphere indicator in the variable names is a prefix or suffix. At this point, only the "prefix" option is available. |
start |
The column that specifies the starting point of a set of variables to be reshaped |
end |
The column that specifies the endpoint of a set of variables to be reshaped |
Value
The long format data
Examples
data(sample_data)
long<-wide2long(
data=sample_data,
ID="ID",
separator="_",
start="lh_Thalamus",
end="rh_AccumbensArea",
hemisphere="prefix"
)