Skip to contents

This function builds upon the eyelinker::read.asc() function to parse the messages and metadata within the EyeLink .asc file. After loading and additional processing, this function returns an S3 eyeris class for use in all subsequent eyeris pipeline steps and functions.

Usage

load_asc(file, block = "auto")

Arguments

file

An SR Research EyeLink .asc file generated by the official EyeLink edf2asc command

block

Optional block number specification. The following are valid options:

  • "auto" (default): Automatically handles multiple recording segments embedded within the same .asc file. We recommend using this default as this is likely the safer choice then assuming a single-block recording (unless you know what you're doing).

  • NULL: Omits block column. Suitable for single-block recordings.

  • Numeric value: Manually sets block number based on the value provided here.

Value

An object of S3 class eyeris with the following attributes:

  1. file: Path to the original .asc file.

  2. timeseries: Dataframe of all raw timeseries data from the tracker.

  3. events: Dataframe of all event messages and their timestamps.

  4. blinks: Dataframe of all blink events.

  5. info: Dataframe of various metadata parsed from the file header.

  6. latest: eyeris variable for tracking pipeline run history.

Details

This function is automatically called by glassbox() by default. If needed, customize the parameters for load_asc by providing a parameter list.

Users should prefer using glassbox() rather than invoking this function directly unless they have a specific reason to customize the pipeline manually.

Note

This function is part of the glassbox() preprocessing pipeline and is not intended for direct use in most cases. Provide parameters via load_asc = list(...).

Advanced users may call it directly if needed.

See also

eyelinker::read.asc() which this function wraps.

glassbox() for the recommended way to run this step as part of the full eyeris glassbox preprocessing pipeline.

Examples

demo_data <- eyelink_asc_demo_dataset()

demo_data |>
  eyeris::glassbox(load_asc = list(block = 1))
#>  [  OK  ] - Running eyeris::load_asc()
#>  [ INFO ] - Processing block: block_1
#>  [  OK  ] - Running eyeris::deblink() for block_1
#>  [  OK  ] - Running eyeris::detransient() for block_1
#>  [  OK  ] - Running eyeris::interpolate() for block_1
#>  [  OK  ] - Running eyeris::lpfilt() for block_1

#> ! [ SKIP ] - Skipping eyeris::downsample() for block_1
#> ! [ SKIP ] - Skipping eyeris::bin() for block_1
#> ! [ SKIP ] - Skipping eyeris::detrend() for block_1
#>  [  OK  ] - Running eyeris::zscore() for block_1
#> 
#> Block processing summary:
#>   block_1: OK (steps: 6, latest: pupil_raw_deblink_detransient_interpolate_lpfilt_z)
#> 
#>  [  OK  ] - Running eyeris::summarize_confounds()
#> $file
#> [1] "/home/runner/work/_temp/Library/eyeris/extdata/memory.asc"
#> 
#> $timeseries
#> $timeseries$block_1
#> # A tibble: 20,767 × 15
#>    block time_orig time_secs time_scaled eye_x eye_y eye      hz type  pupil_raw
#>    <dbl>     <int>     <dbl>       <dbl> <dbl> <dbl> <chr> <dbl> <chr>     <dbl>
#>  1     1  11334491     0           0      982.  555. R      1000 diam…      6198
#>  2     1  11334492     0.001       0.001  981.  554. R      1000 diam…      6201
#>  3     1  11334493     0.002       0.002  981   553. R      1000 diam…      6201
#>  4     1  11334494     0.003       0.003  981.  554. R      1000 diam…      6202
#>  5     1  11334495     0.004       0.004  981.  554. R      1000 diam…      6202
#>  6     1  11334496     0.005       0.005  981.  553  R      1000 diam…      6200
#>  7     1  11334497     0.006       0.006  982.  551. R      1000 diam…      6198
#>  8     1  11334498     0.007       0.007  983   550. R      1000 diam…      6196
#>  9     1  11334499     0.008       0.008  984.  551. R      1000 diam…      6196
#> 10     1  11334500     0.009       0.009  983.  552. R      1000 diam…      6199
#> # ℹ 20,757 more rows
#> # ℹ 5 more variables: pupil_raw_deblink <dbl>,
#> #   pupil_raw_deblink_detransient <dbl>,
#> #   pupil_raw_deblink_detransient_interpolate <dbl>,
#> #   pupil_raw_deblink_detransient_interpolate_lpfilt <dbl>,
#> #   pupil_raw_deblink_detransient_interpolate_lpfilt_z <dbl>
#> 
#> 
#> $events
#> $events$block_1
#> # A tibble: 67 × 4
#>    block     time text                       text_unique               
#>    <dbl>    <dbl> <chr>                      <chr>                     
#>  1     1 11242177 !MODE RECORD CR 1000 2 1 R !MODE RECORD CR 1000 2 1 R
#>  2     1 11334491 EXP_START                  EXP_START                 
#>  3     1 11334491 TRIALID 22                 TRIALID 22                
#>  4     1 11334491 START_TRIAL_22             START_TRIAL_22            
#>  5     1 11334491 CUE_START_22               CUE_START_22              
#>  6     1 11335466 CUE_STOP_22                CUE_STOP_22               
#>  7     1 11335467 DELAY_START_22             DELAY_START_22            
#>  8     1 11336473 DELAY_STOP_22              DELAY_STOP_22             
#>  9     1 11336474 PROBE_START_22             PROBE_START_22            
#> 10     1 11337158 RESPONSE_22                RESPONSE_22               
#> # ℹ 57 more rows
#> 
#> 
#> $blinks
#> $blinks$block_1
#> # A tibble: 1 × 5
#>   block    stime    etime   dur eye  
#>   <dbl>    <dbl>    <dbl> <dbl> <fct>
#> 1     1 11348253 11348308    56 R    
#> 
#> 
#> $info
#>                  date        model version sample.rate   cr  left right mono
#> 1 2009-01-11 02:40:47 EyeLink 1000   4.594        1000 TRUE FALSE  TRUE TRUE
#>   screen.x screen.y                                 mount filter.level
#> 1     1920     1080 Desktop / Monocular / Head Stabilized            2
#>   sample.dtype event.dtype pupil.dtype velocity resolution htarg input buttons
#> 1         GAZE        GAZE    DIAMETER    FALSE      FALSE FALSE  TRUE   FALSE
#> 
#> $latest
#> $latest$block_1
#> [1] "pupil_raw_deblink_detransient_interpolate_lpfilt_z"
#> 
#> 
#> $decimated.sample.rate
#> [1] NA
#> 
#> $params
#> $params$load_asc
#> $params$load_asc$call
#> eyeris::glassbox(file = demo_data, load_asc = list(block = 1))
#> 
#> $params$load_asc$parameters
#> $params$load_asc$parameters$block
#> [1] 1
#> 
#> 
#> 
#> $params$deblink
#> $params$deblink$call
#> eyeris::glassbox(file = demo_data, load_asc = list(block = 1))
#> 
#> $params$deblink$parameters
#> $params$deblink$parameters$extend
#> [1] 50
#> 
#> 
#> 
#> $params$detransient
#> $params$detransient$call
#> eyeris::glassbox(file = demo_data, load_asc = list(block = 1))
#> 
#> $params$detransient$parameters
#> $params$detransient$parameters$n
#> [1] 16
#> 
#> $params$detransient$parameters$mad_thresh
#> NULL
#> 
#> 
#> 
#> $params$interpolate
#> $params$interpolate$call
#> eyeris::glassbox(file = demo_data, load_asc = list(block = 1))
#> 
#> $params$interpolate$parameters
#> $params$interpolate$parameters$verbose
#> [1] TRUE
#> 
#> 
#> 
#> $params$lpfilt
#> $params$lpfilt$call
#> eyeris::glassbox(file = demo_data, load_asc = list(block = 1))
#> 
#> $params$lpfilt$parameters
#> $params$lpfilt$parameters$wp
#> [1] 4
#> 
#> $params$lpfilt$parameters$ws
#> [1] 8
#> 
#> $params$lpfilt$parameters$rp
#> [1] 1
#> 
#> $params$lpfilt$parameters$rs
#> [1] 35
#> 
#> $params$lpfilt$parameters$plot_freqz
#> [1] TRUE
#> 
#> 
#> 
#> $params$z
#> $params$z$call
#> eyeris::glassbox(file = demo_data, load_asc = list(block = 1))
#> 
#> $params$z$parameters
#> list()
#> 
#> 
#> 
#> $confounds
#> $confounds$unepoched_timeseries
#> $confounds$unepoched_timeseries$block_1
#> $confounds$unepoched_timeseries$block_1$pupil_raw
#>   sampling_rate_hz total_time_ms n_samples n_invalid prop_invalid n_gaps
#> 1             1000         20766     20767        74  0.003563346      1
#>   max_gap_n_samples max_gap_duration_ms min_gap_n_samples min_gap_duration_ms
#> 1                74                  74                74                  74
#>   mean_gap_n_samples mean_gap_duration_ms screen_width screen_height
#> 1                 74                   74         1920          1080
#>   gaze_x_var_px gaze_y_var_px mean_gaze_distance_from_center_px
#> 1      197.3489      780.2944                          21.01572
#>   mean_gaze_distance_from_center_norm prop_clipped n_blinks blink_rate_hz
#> 1                          0.02866172   0.00014446        1    0.04815564
#>   min_blink_duration_ms max_blink_duration_ms mean_blink_duration_ms
#> 1                    56                    56                     56
#>   total_blink_time_ms prop_blink_time
#> 1                  56     0.002696716
#> 
#> $confounds$unepoched_timeseries$block_1$pupil_raw_deblink
#>   sampling_rate_hz total_time_ms n_samples n_invalid prop_invalid n_gaps
#> 1             1000         20766     20767       156  0.007511918      1
#>   max_gap_n_samples max_gap_duration_ms min_gap_n_samples min_gap_duration_ms
#> 1               156                 156               156                 156
#>   mean_gap_n_samples mean_gap_duration_ms screen_width screen_height
#> 1                156                  156         1920          1080
#>   gaze_x_var_px gaze_y_var_px mean_gaze_distance_from_center_px
#> 1      197.3489      780.2944                          21.01572
#>   mean_gaze_distance_from_center_norm prop_clipped n_blinks blink_rate_hz
#> 1                          0.02866172 9.630664e-05        1    0.04815564
#>   min_blink_duration_ms max_blink_duration_ms mean_blink_duration_ms
#> 1                   156                   156                    156
#>   total_blink_time_ms prop_blink_time
#> 1                 156      0.00751228
#> 
#> $confounds$unepoched_timeseries$block_1$pupil_raw_deblink_detransient
#>   sampling_rate_hz total_time_ms n_samples n_invalid prop_invalid n_gaps
#> 1             1000         20766     20767       156  0.007511918      1
#>   max_gap_n_samples max_gap_duration_ms min_gap_n_samples min_gap_duration_ms
#> 1               156                 156               156                 156
#>   mean_gap_n_samples mean_gap_duration_ms screen_width screen_height
#> 1                156                  156         1920          1080
#>   gaze_x_var_px gaze_y_var_px mean_gaze_distance_from_center_px
#> 1      197.3489      780.2944                          21.01572
#>   mean_gaze_distance_from_center_norm prop_clipped n_blinks blink_rate_hz
#> 1                          0.02866172 9.630664e-05        1    0.04815564
#>   min_blink_duration_ms max_blink_duration_ms mean_blink_duration_ms
#> 1                   156                   156                    156
#>   total_blink_time_ms prop_blink_time
#> 1                 156      0.00751228
#> 
#> $confounds$unepoched_timeseries$block_1$pupil_raw_deblink_detransient_interpolate
#>   sampling_rate_hz total_time_ms n_samples n_invalid prop_invalid n_gaps
#> 1             1000         20766     20767        NA           NA      0
#>   max_gap_n_samples max_gap_duration_ms min_gap_n_samples min_gap_duration_ms
#> 1                 0                   0                 0                   0
#>   mean_gap_n_samples mean_gap_duration_ms screen_width screen_height
#> 1                  0                    0         1920          1080
#>   gaze_x_var_px gaze_y_var_px mean_gaze_distance_from_center_px
#> 1      197.3489      780.2944                          21.01572
#>   mean_gaze_distance_from_center_norm prop_clipped n_blinks blink_rate_hz
#> 1                          0.02866172 9.630664e-05        0             0
#>   min_blink_duration_ms max_blink_duration_ms mean_blink_duration_ms
#> 1                    NA                    NA                     NA
#>   total_blink_time_ms prop_blink_time
#> 1                   0               0
#> 
#> $confounds$unepoched_timeseries$block_1$pupil_raw_deblink_detransient_interpolate_lpfilt
#>   sampling_rate_hz total_time_ms n_samples n_invalid prop_invalid n_gaps
#> 1             1000         20766     20767        NA           NA      0
#>   max_gap_n_samples max_gap_duration_ms min_gap_n_samples min_gap_duration_ms
#> 1                 0                   0                 0                   0
#>   mean_gap_n_samples mean_gap_duration_ms screen_width screen_height
#> 1                  0                    0         1920          1080
#>   gaze_x_var_px gaze_y_var_px mean_gaze_distance_from_center_px
#> 1      197.3489      780.2944                          21.01572
#>   mean_gaze_distance_from_center_norm prop_clipped n_blinks blink_rate_hz
#> 1                          0.02866172 9.630664e-05        0             0
#>   min_blink_duration_ms max_blink_duration_ms mean_blink_duration_ms
#> 1                    NA                    NA                     NA
#>   total_blink_time_ms prop_blink_time
#> 1                   0               0
#> 
#> $confounds$unepoched_timeseries$block_1$pupil_raw_deblink_detransient_interpolate_lpfilt_z
#>   sampling_rate_hz total_time_ms n_samples n_invalid prop_invalid n_gaps
#> 1             1000         20766     20767        NA           NA      0
#>   max_gap_n_samples max_gap_duration_ms min_gap_n_samples min_gap_duration_ms
#> 1                 0                   0                 0                   0
#>   mean_gap_n_samples mean_gap_duration_ms screen_width screen_height
#> 1                  0                    0         1920          1080
#>   gaze_x_var_px gaze_y_var_px mean_gaze_distance_from_center_px
#> 1      197.3489      780.2944                          21.01572
#>   mean_gaze_distance_from_center_norm prop_clipped n_blinks blink_rate_hz
#> 1                          0.02866172 9.630664e-05        0             0
#>   min_blink_duration_ms max_blink_duration_ms mean_blink_duration_ms
#> 1                    NA                    NA                     NA
#>   total_blink_time_ms prop_blink_time
#> 1                   0               0
#> 
#> 
#> 
#> 
#> attr(,"class")
#> [1] "eyeris"

# Other useful parameter configurations
## (1) Basic usage (no block column specified)
demo_data |>
  eyeris::load_asc()
#> $file
#> [1] "/home/runner/work/_temp/Library/eyeris/extdata/memory.asc"
#> 
#> $timeseries
#> $timeseries$block_1
#> # A tibble: 20,767 × 10
#>    block time_orig time_secs time_scaled eye_x eye_y eye      hz type  pupil_raw
#>    <dbl>     <int>     <dbl>       <dbl> <dbl> <dbl> <chr> <dbl> <chr>     <dbl>
#>  1     1  11334491     0           0      982.  555. R      1000 diam…      6198
#>  2     1  11334492     0.001       0.001  981.  554. R      1000 diam…      6201
#>  3     1  11334493     0.002       0.002  981   553. R      1000 diam…      6201
#>  4     1  11334494     0.003       0.003  981.  554. R      1000 diam…      6202
#>  5     1  11334495     0.004       0.004  981.  554. R      1000 diam…      6202
#>  6     1  11334496     0.005       0.005  981.  553  R      1000 diam…      6200
#>  7     1  11334497     0.006       0.006  982.  551. R      1000 diam…      6198
#>  8     1  11334498     0.007       0.007  983   550. R      1000 diam…      6196
#>  9     1  11334499     0.008       0.008  984.  551. R      1000 diam…      6196
#> 10     1  11334500     0.009       0.009  983.  552. R      1000 diam…      6199
#> # ℹ 20,757 more rows
#> 
#> 
#> $events
#> $events$block_1
#> # A tibble: 67 × 4
#>    block     time text                       text_unique               
#>    <dbl>    <dbl> <chr>                      <chr>                     
#>  1     1 11242177 !MODE RECORD CR 1000 2 1 R !MODE RECORD CR 1000 2 1 R
#>  2     1 11334491 EXP_START                  EXP_START                 
#>  3     1 11334491 TRIALID 22                 TRIALID 22                
#>  4     1 11334491 START_TRIAL_22             START_TRIAL_22            
#>  5     1 11334491 CUE_START_22               CUE_START_22              
#>  6     1 11335466 CUE_STOP_22                CUE_STOP_22               
#>  7     1 11335467 DELAY_START_22             DELAY_START_22            
#>  8     1 11336473 DELAY_STOP_22              DELAY_STOP_22             
#>  9     1 11336474 PROBE_START_22             PROBE_START_22            
#> 10     1 11337158 RESPONSE_22                RESPONSE_22               
#> # ℹ 57 more rows
#> 
#> 
#> $blinks
#> $blinks$block_1
#> # A tibble: 1 × 5
#>   block    stime    etime   dur eye  
#>   <dbl>    <dbl>    <dbl> <dbl> <fct>
#> 1     1 11348253 11348308    56 R    
#> 
#> 
#> $info
#>                  date        model version sample.rate   cr  left right mono
#> 1 2009-01-11 02:40:47 EyeLink 1000   4.594        1000 TRUE FALSE  TRUE TRUE
#>   screen.x screen.y                                 mount filter.level
#> 1     1920     1080 Desktop / Monocular / Head Stabilized            2
#>   sample.dtype event.dtype pupil.dtype velocity resolution htarg input buttons
#> 1         GAZE        GAZE    DIAMETER    FALSE      FALSE FALSE  TRUE   FALSE
#> 
#> $latest
#> $latest$block_1
#> [1] "pupil_raw"
#> 
#> 
#> $decimated.sample.rate
#> [1] NA
#> 
#> attr(,"class")
#> [1] "eyeris"

## (2) Manual specification of block number
demo_data |>
  eyeris::load_asc(block = 3)
#> $file
#> [1] "/home/runner/work/_temp/Library/eyeris/extdata/memory.asc"
#> 
#> $timeseries
#> $timeseries$block_3
#> # A tibble: 20,767 × 10
#>    block time_orig time_secs time_scaled eye_x eye_y eye      hz type  pupil_raw
#>    <dbl>     <int>     <dbl>       <dbl> <dbl> <dbl> <chr> <dbl> <chr>     <dbl>
#>  1     3  11334491     0           0      982.  555. R      1000 diam…      6198
#>  2     3  11334492     0.001       0.001  981.  554. R      1000 diam…      6201
#>  3     3  11334493     0.002       0.002  981   553. R      1000 diam…      6201
#>  4     3  11334494     0.003       0.003  981.  554. R      1000 diam…      6202
#>  5     3  11334495     0.004       0.004  981.  554. R      1000 diam…      6202
#>  6     3  11334496     0.005       0.005  981.  553  R      1000 diam…      6200
#>  7     3  11334497     0.006       0.006  982.  551. R      1000 diam…      6198
#>  8     3  11334498     0.007       0.007  983   550. R      1000 diam…      6196
#>  9     3  11334499     0.008       0.008  984.  551. R      1000 diam…      6196
#> 10     3  11334500     0.009       0.009  983.  552. R      1000 diam…      6199
#> # ℹ 20,757 more rows
#> 
#> 
#> $events
#> $events$block_3
#> # A tibble: 67 × 4
#>    block     time text                       text_unique               
#>    <dbl>    <dbl> <chr>                      <chr>                     
#>  1     3 11242177 !MODE RECORD CR 1000 2 1 R !MODE RECORD CR 1000 2 1 R
#>  2     3 11334491 EXP_START                  EXP_START                 
#>  3     3 11334491 TRIALID 22                 TRIALID 22                
#>  4     3 11334491 START_TRIAL_22             START_TRIAL_22            
#>  5     3 11334491 CUE_START_22               CUE_START_22              
#>  6     3 11335466 CUE_STOP_22                CUE_STOP_22               
#>  7     3 11335467 DELAY_START_22             DELAY_START_22            
#>  8     3 11336473 DELAY_STOP_22              DELAY_STOP_22             
#>  9     3 11336474 PROBE_START_22             PROBE_START_22            
#> 10     3 11337158 RESPONSE_22                RESPONSE_22               
#> # ℹ 57 more rows
#> 
#> 
#> $blinks
#> $blinks$block_3
#> # A tibble: 1 × 5
#>   block    stime    etime   dur eye  
#>   <dbl>    <dbl>    <dbl> <dbl> <fct>
#> 1     3 11348253 11348308    56 R    
#> 
#> 
#> $info
#>                  date        model version sample.rate   cr  left right mono
#> 1 2009-01-11 02:40:47 EyeLink 1000   4.594        1000 TRUE FALSE  TRUE TRUE
#>   screen.x screen.y                                 mount filter.level
#> 1     1920     1080 Desktop / Monocular / Head Stabilized            2
#>   sample.dtype event.dtype pupil.dtype velocity resolution htarg input buttons
#> 1         GAZE        GAZE    DIAMETER    FALSE      FALSE FALSE  TRUE   FALSE
#> 
#> $latest
#> $latest$block_3
#> [1] "pupil_raw"
#> 
#> 
#> $decimated.sample.rate
#> [1] NA
#> 
#> attr(,"class")
#> [1] "eyeris"

## (3) Auto-detect multiple recording segments embedded within the same file
##  (i.e., the default behavior)
demo_data |>
  eyeris::load_asc(block = "auto")
#> $file
#> [1] "/home/runner/work/_temp/Library/eyeris/extdata/memory.asc"
#> 
#> $timeseries
#> $timeseries$block_1
#> # A tibble: 20,767 × 10
#>    block time_orig time_secs time_scaled eye_x eye_y eye      hz type  pupil_raw
#>    <dbl>     <int>     <dbl>       <dbl> <dbl> <dbl> <chr> <dbl> <chr>     <dbl>
#>  1     1  11334491     0           0      982.  555. R      1000 diam…      6198
#>  2     1  11334492     0.001       0.001  981.  554. R      1000 diam…      6201
#>  3     1  11334493     0.002       0.002  981   553. R      1000 diam…      6201
#>  4     1  11334494     0.003       0.003  981.  554. R      1000 diam…      6202
#>  5     1  11334495     0.004       0.004  981.  554. R      1000 diam…      6202
#>  6     1  11334496     0.005       0.005  981.  553  R      1000 diam…      6200
#>  7     1  11334497     0.006       0.006  982.  551. R      1000 diam…      6198
#>  8     1  11334498     0.007       0.007  983   550. R      1000 diam…      6196
#>  9     1  11334499     0.008       0.008  984.  551. R      1000 diam…      6196
#> 10     1  11334500     0.009       0.009  983.  552. R      1000 diam…      6199
#> # ℹ 20,757 more rows
#> 
#> 
#> $events
#> $events$block_1
#> # A tibble: 67 × 4
#>    block     time text                       text_unique               
#>    <dbl>    <dbl> <chr>                      <chr>                     
#>  1     1 11242177 !MODE RECORD CR 1000 2 1 R !MODE RECORD CR 1000 2 1 R
#>  2     1 11334491 EXP_START                  EXP_START                 
#>  3     1 11334491 TRIALID 22                 TRIALID 22                
#>  4     1 11334491 START_TRIAL_22             START_TRIAL_22            
#>  5     1 11334491 CUE_START_22               CUE_START_22              
#>  6     1 11335466 CUE_STOP_22                CUE_STOP_22               
#>  7     1 11335467 DELAY_START_22             DELAY_START_22            
#>  8     1 11336473 DELAY_STOP_22              DELAY_STOP_22             
#>  9     1 11336474 PROBE_START_22             PROBE_START_22            
#> 10     1 11337158 RESPONSE_22                RESPONSE_22               
#> # ℹ 57 more rows
#> 
#> 
#> $blinks
#> $blinks$block_1
#> # A tibble: 1 × 5
#>   block    stime    etime   dur eye  
#>   <dbl>    <dbl>    <dbl> <dbl> <fct>
#> 1     1 11348253 11348308    56 R    
#> 
#> 
#> $info
#>                  date        model version sample.rate   cr  left right mono
#> 1 2009-01-11 02:40:47 EyeLink 1000   4.594        1000 TRUE FALSE  TRUE TRUE
#>   screen.x screen.y                                 mount filter.level
#> 1     1920     1080 Desktop / Monocular / Head Stabilized            2
#>   sample.dtype event.dtype pupil.dtype velocity resolution htarg input buttons
#> 1         GAZE        GAZE    DIAMETER    FALSE      FALSE FALSE  TRUE   FALSE
#> 
#> $latest
#> $latest$block_1
#> [1] "pupil_raw"
#> 
#> 
#> $decimated.sample.rate
#> [1] NA
#> 
#> attr(,"class")
#> [1] "eyeris"

## (4) Omit block column
demo_data |>
  eyeris::load_asc(block = NULL)
#> $file
#> [1] "/home/runner/work/_temp/Library/eyeris/extdata/memory.asc"
#> 
#> $timeseries
#> $timeseries$block_1
#> # A tibble: 20,767 × 9
#>    time_orig time_secs time_scaled eye_x eye_y eye      hz type     pupil_raw
#>        <int>     <dbl>       <dbl> <dbl> <dbl> <chr> <dbl> <chr>        <dbl>
#>  1  11334491     0           0      982.  555. R      1000 diameter      6198
#>  2  11334492     0.001       0.001  981.  554. R      1000 diameter      6201
#>  3  11334493     0.002       0.002  981   553. R      1000 diameter      6201
#>  4  11334494     0.003       0.003  981.  554. R      1000 diameter      6202
#>  5  11334495     0.004       0.004  981.  554. R      1000 diameter      6202
#>  6  11334496     0.005       0.005  981.  553  R      1000 diameter      6200
#>  7  11334497     0.006       0.006  982.  551. R      1000 diameter      6198
#>  8  11334498     0.007       0.007  983   550. R      1000 diameter      6196
#>  9  11334499     0.008       0.008  984.  551. R      1000 diameter      6196
#> 10  11334500     0.009       0.009  983.  552. R      1000 diameter      6199
#> # ℹ 20,757 more rows
#> 
#> 
#> $events
#> # A tibble: 67 × 3
#>        time text                       text_unique               
#>       <dbl> <chr>                      <chr>                     
#>  1 11242177 !MODE RECORD CR 1000 2 1 R !MODE RECORD CR 1000 2 1 R
#>  2 11334491 EXP_START                  EXP_START                 
#>  3 11334491 TRIALID 22                 TRIALID 22                
#>  4 11334491 START_TRIAL_22             START_TRIAL_22            
#>  5 11334491 CUE_START_22               CUE_START_22              
#>  6 11335466 CUE_STOP_22                CUE_STOP_22               
#>  7 11335467 DELAY_START_22             DELAY_START_22            
#>  8 11336473 DELAY_STOP_22              DELAY_STOP_22             
#>  9 11336474 PROBE_START_22             PROBE_START_22            
#> 10 11337158 RESPONSE_22                RESPONSE_22               
#> # ℹ 57 more rows
#> 
#> $blinks
#> # A tibble: 1 × 4
#>      stime    etime   dur eye  
#>      <dbl>    <dbl> <dbl> <fct>
#> 1 11348253 11348308    56 R    
#> 
#> $info
#>                  date        model version sample.rate   cr  left right mono
#> 1 2009-01-11 02:40:47 EyeLink 1000   4.594        1000 TRUE FALSE  TRUE TRUE
#>   screen.x screen.y                                 mount filter.level
#> 1     1920     1080 Desktop / Monocular / Head Stabilized            2
#>   sample.dtype event.dtype pupil.dtype velocity resolution htarg input buttons
#> 1         GAZE        GAZE    DIAMETER    FALSE      FALSE FALSE  TRUE   FALSE
#> 
#> $latest
#> $latest$block_1
#> [1] "pupil_raw"
#> 
#> 
#> $decimated.sample.rate
#> [1] NA
#> 
#> attr(,"class")
#> [1] "eyeris"