search_omv {jmvReadWrite}

Search values in .omv-files for the statistical spreadsheet 'jamovi' (https://www.jamovi.org)

Description

Search values in .omv-files for the statistical spreadsheet 'jamovi' (https://www.jamovi.org)

Usage

search_omv(
  dtaInp = NULL,
  srcTrm = c(),
  whlTrm = FALSE,
  ignCse = FALSE,
  incNum = TRUE,
  incOrd = TRUE,
  incNom = TRUE,
  incID = TRUE,
  incCmp = TRUE,
  incRcd = TRUE,
  ...
)

Arguments

dtaInp

Either a data frame or the name of a jamovi data file to be read (including the path, if required; "FILENAME.omv"; default: NULL)

srcTrm

(Character or numeric) Vector (with length = 1) with a search term to be found in the data frame (default: c())

whlTrm

Whether the exact search term shall be found (TRUE) or whether a partial match is sufficient (FALSE; default: FALSE)

ignCse

Whether to ignore the case of the search term (default: FALSE)

incNum

Whether to include continuous variables in the search (default: TRUE)

incOrd

Whether to include ordinal variables in the search (default: TRUE)

incNom

Whether to include nominal variables in the search (default: TRUE)

incID

Whether to include ID variables in the search (default: TRUE)

incCmp

Whether to include Computed variables in the search (default: TRUE)

incRcd

Whether to include Recoded variables in the search (default: TRUE)

...

Additional arguments passed on to methods; see Details below

Details

• The ellipsis-parameter (...) can be used to submit arguments / parameters to the function that is used for reading and writing the data. Clicking on the respective function under “See also”, you can get a more detailed overview over which parameters each of those functions take. The functions are: read_omv and write_omv (for jamovi-files).

Value

a named list with the places where the search term was found: names in the list are the variables / columns, the entries the respective row names within that variable / column (row names are used for being tolerant to filtered-out cases in jamovi, if a filter is used, row numbers would be incorrect)

See Also

replace_omv uses read_omv() and write_omv() for reading and writing jamovi-files.

Examples

## Not run: 
# the exact value 24 appears 13 times in age
bfi_sample <- jmvReadWrite::bfi_sample
jmvReadWrite::search_omv(bfi_sample, 24, whlTrm = TRUE)
# taking the fifth entry from the search results
bfi_sample["61", "age"]
# with the following search, both Males and Females are found
# (the M of Males, wouldn't be matched if ignCse were FALSE and males is
#  only a partial match within Females, thus whlTrm must be set to FALSE)
jmvReadWrite::search_omv(bfi_sample, "males", whlTrm = FALSE, ignCse = TRUE)
# the first entry is a female, the first entry is a male
bfi_sample["1", "gender"] # Females
bfi_sample["6", "gender"] # Males
# using the search results assigned to a variable
srcRes <- jmvReadWrite::search_omv(bfi_sample, "males", whlTrm = FALSE, ignCse = TRUE)
bfi_sample[srcRes[[1]][1], names(srcRes[1])] # Females
bfi_sample[srcRes[[1]][6], names(srcRes[1])] # Males

## End(Not run)