,

Bug fixed

  • could not find function "across." error fixed (thanks @prattems)

New Features

  • Added chs_mean method for psd_list objects.
  • Introduced experimental read_fif() function to read fif files created by MNE Python.
  • New install_py_eeguana() function to install the necessary Python packages for reading fif files.

Bugs and Improvements

  • Improved behavior of channel_dbl and sample_int classes.
  • Enhanced annotate_events() function to allow plotting even if there are no events.
  • fix installation of the dependency tidytable.
  • added annotate_electrodes() to add electrode labels to a topographic plot. (Previously this was done with geom_text()).
  • fix of minor bug affecting eeg_artif_step(), when the number of samples in window was odd.
  • as_eeg_lst() makes eeg_lst objects created with previous versions of eeguana compatible with the current version.
  • New features:
  • The argument .ref of eeg_rereference() now allows “tidyselect”.
  • Modifying channels with channels_tbl() is much faster now.
  • Signal filtering is slightly faster and uses the gsignal package.
  • BUGS:
    • some brainvision files produced by eeglab couldn’t be read now work
  • DEPRECATIONS:
    • The argument .all_chs of eeg_events_to_NA was deprecated in favor of the more flexible .n_chs.
  • Breaking change: _at, _if, _all functions don’t work anymore. Now one should use the new across() (or across_ch()) notation. If your code doesn’t work anymore and you don’t know how to fix it, please post it in https://github.com/bnicenboim/eeguana/discussions
  • Potential breaking change: when segments with repeated columns are joined, they use data.table notation (i...) rather than dplyr notation. This might affect the join family and eeg_segment.
  • dplyr-like functions get an eeg_ prefix (e.g., eeg_mutate, eeg_filter), they still work without the prefix (for now).
  • NEW FEATURES:
    • filters have more options (including IIR, experimental).
    • read eeglab set files (still experimental)
  • documentation:
    • more examples
  • internal changes:
    • removed dependency with stringr
    • changed internal structure of eeg_lst, the segments table is a data.table rather than a tibble and they depend on tidytable
  • Bugs:
    • weird dplyr filter behavior fixed #136
  • Changes
    • plot_components() behaves more similarly to plot_topo()
    • BREAKING CHANGE ... are always the second argument and most arguments require now a . at the beginning: This should help to differentiate them from channels.
  • Improvements
    • New examples for ICA functions.
    • Much faster mutate functions
    • Better error messages for reading Brain Vision files @jaromilfrossard
    • scale works properly for channels now
  • Additions
  • Bugs: tons of compatibility issues with dplyr 1.0
  • Changes
    • Signal processing functions added sig_fft(), sig_ifft().
    • Better print method for channels.
    • More consistent events_tbl with obligatory .type and .description
  • More unit testing.
  • Bugs:
    • read_edf() wasn’t reading events from the status channel
    • fixed some inconsistencies with .reference argument
  • Changes
    • New vignette that introduces the package here.
    • FastICA was implemented in eeg_ica().
    • Artifact detection functions in eeg_artif_*().
    • Filters were greatly improved and checked, only FIR filters are supported for now, based on MNE.
    • Better documentation (mostly Kate Stone).
    • Easy access to the information of the different tables with signal_tbl(), events_tbl(), and segments_tbl().
    • Changes in the creation of eeg_lst objects.
    • Faster as_tibble().
    • as.data.table() was added.
    • Renamed functions:
  • Bugs
    • Events in Brain Vision version 1.0 file are now correctly read.
    • Various minor bugs fixed.
  • Changes
  • Bugs
  • Internal changes:
    • Better test structure.
    • Better validation of objects.
  • Changes
    • chs_fun() to apply arbitrary functions to the channels.
    • Fieldtrip tutorial added as a vignette.
  • Bugs
    • Channels appear in the right order in plots.
    • Other minor bugs.
  • Changes
    • ggplot2 theme improved.
    • changed the default downsampling in plots.
    • better handling of weird channel names.
    • segment() accepts initial and final segments.
    • summarize adds a summarize_n column.
    • events function to visualize and edit events was added.
    • various filters were added.
  • Bugs
    • ch_rereference updates the relevant attributes.
    • bugs in various reading functions were fixed (int encoding issues).
    • mutate recognize better channels.
    • *_join functions fixed.
  • Signals table is now powered by data.table.
  • Added a NEWS.md file to track changes to the package.