This release adds support for Pupil LSL Relay 2.0 which makes XDF datasets much smaller than before and makes it much easier to gather the data. Using V2.0 data is now highly recommended because of how much faster it is to load and process!

Because of this change, we can now gather the timeseries for any of the available data points in the Gaze meta format. See test_yaml3.yml for an example config file that uses these new fields:

        - confidence
        - norm_pos_x
        - norm_pos_y
        - gaze_point_3d_x
        - gaze_point_3d_y
        - gaze_point_3d_z
        - eye_center0_3d_x
        - eye_center0_3d_y
        - eye_center0_3d_z
        - eye_center1_3d_x
        - eye_center1_3d_y
        - eye_center1_3d_z
        - gaze_normal0_x
        - gaze_normal0_y
        - gaze_normal0_z
        - gaze_normal1_x
        - gaze_normal1_y
        - gaze_normal1_z
        - diameter0_2d
        - diameter1_2d
        - diameter0_3d
        - diameter1_3d

The following changes have been made since v1.0.0, these have also been incorporated in the pypi module:

1. Matlab '.mat' output is now supported! Instead of save_csv, use save_mat to store '.mat' files.
2. Merging multiple datasets is working as expected now.
3. Simplified rejected trial exclusion/inclusion from data. At any level of the data_container objects, set datastore.exclude_rejects = False to include rejected trials in the data obtained from get_matrix calls. Setting this flag to False also changes what is saved with the save_csv and save_mat functions since they use get_matrix to gather data that needs to be saved.
4. Raw trial data that is processed by some pre/post functions is no longer overwritten by the processed data. This data now exists in the proc data_type rather than the original data type.
5. Added --save-mat and --prefix to the optional arguments that can be used from the command line interface.
6. .data can now be used to access the processed data instead of .data_store. .data_store is still available but will be removed in a future release.
7. Documentation was updated to reflect the changes.
8. (Under-the-hood) Logging is now a bit simpler, and not as verbose as before. With this patch, preparations are being made to remove threaded options.

This update primarily contains large processor updates, with various bug fixes and import error fixes.

A new CLI command is also added. Now, python pupil_lib.py is replaced with pupillib.
After running python setup.py install, run pupillib --help to test it out.

With these changes, it also brings us to the first post-beta release of the library as the majority of the functionality is ready to be used.

First beta release for the Pupil-Lib Trial Extraction (or Data Segmentation/Epoching) Library in Python with all basic functionality complete and documented.