- clear some notes and warnings in preparation for CRAN submission (#265)
build_secuTrial_url()
now has optional parameterprefix
with default"apps/WebObjects/"
. (#263)
- bug fix to read escaped enclosure characters in free text items, e.g.
\"
(#220, #261)read_export_options()
now also reads enclosure character from header.print.secuTrialoptions()
now also prints enclosure character. Quote and Tabulator are now printed as'\"'
and'\t'
rather than'"'
and' '
.read_export_table()
now usesreadr::read_delim()
with optionsescape_backslash = TRUE
andquote = export_options$quote
- warning for ISO-8859 encoding moved from
read_export_table()
toread_secuTrial_raw()
(one warning per export file instead of several warnings for each table) read_export_options()
now reads only the first 10 lines to find the encoding. Reading all lines would fail if the export options were ISO-8859 encoded and contained 'problematic' characaters, e.g. in center names.- Removed
encoding
option inplot_recruitment()
: Not needed here, as centres are read with correct encoding inread_secuTrial_raw()
and stored in the secuTrialR object.
write_secuTrial()
no longer allowsformat = "sas"
due to deprecation of write_sas inhaven
(version 2.5.2).read_secuTrial_raw
now produces a more explicit warning when ISO-8859 encoding is used. Recent changes in R seem to have reduced compatibility with this encoding.
- fix CRAN notes - remove codecov badge, check class via inherits
- warning regarding overwritten
pat_id
variable
- adapt
as.data.frame.secuTrialData()
to allow named character vectors as optiondata.frames
to specify custom names for data.frames (#250)
- recommendation to export with short names (#238)
- addition of arguments in
read_export_table
etc allowing passing other options toread.table
(#240) - addition of
dictionary_secuTrial
function for easy access a data dictionary (#241) formtablename
added to the output ofvisit_structure
for better reference between the table names and labels (#242)- addition of
export_date
andexport_datetime
for easier access to the export date (and time) (#246)
- adapt
read_export_options()
to work with exports from new secuTrial version (6.1.2.5 - 6.3.2.5) (#245)
- transferred the
Maintainer
tag toAlan Haynes
- reverted
factorize_secuTrial()
back to 1.0.3 version due to problems with lookup table factorization (#224) - added citation (doi: 10.21105/joss.02816)
- moved
tcltk
andigraph
dependency to suggested (#223)
- added
skip
parameter toread_validation_overview()
(#212)
- fixed a bug where
subset_secuTrial()
would drop labels during the subsetting process (#203)
- improved import speed, specifically through changes in
dates_secutrial()
andfactorize_secutrial()
(#204)
- adjustments to handle review feedback from CRAN (#190)
- clarify correct options in
read_secuTrial()
failure message (#187) - check for
project_setup
invisit_structure()
(#181)
- added "Form meta data: Structure" export option information to
export_options
(#182) - added error handling for missing structure data when running
annual_recruitment()
andreturn_random_participants()
(#182)
- restructuring in preparation for a release on CRAN
- added suggestion to NOT export form data of hidden fields (#177)
- added check to make sure that specified centres are part of the export in
return_random_participants()
(#151)
- extended failure comment in
read_secuTrial()
to indicate that the problem could be a rectangular export file (#168) - added "Form data of hidden fields" export option information to
export_options
(#171) - added
return_hidden_items()
function (#172)
- bug fix: presence of the audit trail was incorrectly identified due to a comment in the source file of the export options (see #155, comments from @suvi-subra and @OliviaEbnerIAS)
- Added sorting option to visit_structure. (#152)
- adjusted warning message in
label_secuTrial()
- only allow unique labels in
label_secuTrial()
- added "Frequent warning messages" paragraph to the vignette (#156)
- added up-to-date vignette (#99)
- path in
print.secuTrialdata
is now wrapped at 80 characters
secutrialoptions
class is nowsecuTrialoptions
.
- add appveyor testing, pkgdown site
- fix possible bug on windows due to regex in .prep_line_items (used in plot_recruitment) (#147)
- Changed license for the package from GPL-2 to MIT.
- The general nomenclature for a study subject will from now on be participant (pat). All variations of this (e.g. case, patient) have been adjusted in the code and the documentation.
- Removed generic
plot()
function forsecuTrialdata
objects. (#139)
read_secuTrial()
andread_secuTrial_raw()
now check if the input file exists. (#137)
factorize_secuTrial()
warning messages have been adjusted to improve trouble shooting experience. (#134, #135)
dates_secuTrial()
incomplete date warnings are now concatenated and returned as one warning per form instead of many. (#124)
- Fixed issue #121 on GitHub.
factorize_secuTrial()
can now handle exports which have the reset option enabled in radio buttons.
write_secuTrial()
now allows xpt version 8 files to be written. (closes #57)
check_export_options()
function was added. It informs on deviations from suggested export options. (closes #17)- Removed tracking of obsolete export options (
partial_date_string
,partial_date_handling
,unknown_date_string
). - Added
format_info
(e.g. "CSV format for MS Excel") toexport_options
.
- Fixed issue #116 on GitHub.
subset_secuTrial()
function was added. It allows subsetting of secuTrialdata based on patient ID and/or study centre name.get_participants()
function was added. It allows easy extractions of participant info from a secuTrialdata object.
return_random_cases()
now returns a list. The first element are the cases and the second element is the output ofRNGkind()
.
- New function
diff_secuTrial()
added to allow light weight comparison of the setup of two secuTrial exports.
- Metadata variables are now also transformed to date and datetime formats, whenever appropriate.
factorize_secuTrial()
now no longer triggers an unexpected warning when the name of a secuTrial lookuptable is equal to the name of the variable it is being used in. (PR #108)
return_random_cases()
has been added to the package. It allows to sample a random subset of cases from a secuTrial export in a reproducible fashion.
read_secuTrial_raw()
andread_secuTrial()
no longer fail due to missing Add-ID, centre information or project setup in export data. Instead, adding ofpat_id
(no Add-ID),centre
(no centre information) andvisit_name
(no project setup) to the data tables is now omitted if the relevant data for the operation is not available.
read_secuTrial_raw()
andread_secuTrial()
no longer fail due to missing "Description" in export options.
dates_secuTrial()
now warns if not all dates were parsed (expected if there are incomplete dates).factorize_secuTrial()
now warns if there are issues with the factorization (not expected to trigger).
- New function
build_secuTrial_url()
has been added. It allows users to easily compose URLs to specific secuTrial forms.
- The function name of
read_secuTrial_export()
has been changed toread_secuTrial_raw()
to avoid confusion withread_secuTrial()
.
- As of version 0.4.17, changes will be recorded in the NEWS file.