- Fix
cyto_gate_bool()to anchor new nodes to most recent ancestor in the GatingSet. - Fix labelling of transformed axes within
cyto_plot(). - Fix statistics computation in
cyto_plot()when gates and overlays are present. - Fix
cyto_plot_gating_scheme()to allow the use of custom colour scale whenback_gate = TRUE. - Make sure
cyto_load()is able to read in saved GatingSets.
- Add
selectargument tocyto_stats_compute()to allow computation of statistics for a subset of samples based on experimental variables. - Add new
cyto_gate_bool()function to add boolean gates to the GatingSet and gatingTemplate. - Improve
cyto_channels_restrict()to drop unused channels in cytometry objects. Add anexcludeargument to forcibly remove FSC, SSC or Time parameters. Therestrictargument incyto_setup()now accepts a vector of channels to be passed internally to theexcludeargument ofcyto_channels_restrict(). - Add support for forward gating by colouring points based on the expression of a particular marker in
cyto_plot(), simply pass the name of the marker to thepoint_colargument. - Update default density colour scale for points to include a darker blue at the lower end of the scale. This provides better resolution at the lower end of the scale and balances the colour gradient.
- Add channels argument to
cyto_extract()to restrict data to certain channels when it is extracted from a GatingHierarchy or GatingSet. - Add new function
cyto_names_parse()to split file names into experiment variables incyto_details(). Files should be named with each variable separated by a delimiter. For example, file named 160520-Exp1-StimA.fcs can be separated into variables date, experiment and treatment.parse_namesargument has been added tocyto_setup()to allow name parsing when files are loaded in. - Custom functions can now be supplied by name to the
typeargument incyto_map(). This means that you can use any available dimensionality reduction technique or create your own one to map your data. - Add
cyto_gatingTemplate_generate()to obtain a CytoExploreR-ready gatingTemplate from any GatingHierarchy or GatingSet. - Improve speed of plotting using
cyto_plot()by increasing computation speed of axes ranges. - Add support for
scattermoreto further improvecyto_plot()plotting speed. To use this feature, users will need to manually installscattermoreand setoptions("cyto_plot_fast" = TRUE). Settingoptions("cyto_plot_fast" = FALSE)will return to using conventional plotting. It is recommended to use conventional plotting when saving images withcyto_plot_save()to obtain high resolution images. - Fix quadrant gate bug in
cyto_gate_edit()to allow editing of quadrant gates. - Fix computation of statistics for stacked density distributions in
cyto_plot(). - Fix
cyto_marker_edit()to accept custom file name for saving and add support for marker removal. - Hide messages when opening data editors and only open data editors in interactive mode.
- Improve visualization of quadrant gates to distinguish them from traditional rectangleGates. Quadrant gates can now be individually visualized (i.e. users can indicate which quadrants to display).
- Added new function
cyto_nodes_convert()to anchor ambiguous nodes to a known parental node withincyto_plot().
- Fix quadrant gating bug in
cyto_gate_draw(). cyto_map()can now appropriately handle empty flowFrames/cytoframes.- Switch to using
rsvd::rpca()for faster PCA computation incyto_map(). - Add versioned and latest tags to CytoExploreR Docker images for reproducibility. Docker images are always built against the most recent RGLab packages at the time. Versioned Docker images allow users to go back in time should they need to.
- Update FIt-SNE to version
1.2.1. This change requires updated installation of FIt-SNE and now requires thersvdpackage. FIt-SNE now uses PCA initialization by default. - Configure Docker images with FIt-SNE and search for
fast_tsnelocation automatically. Hide this directory to prevent accidental deletion. - Add FIt-SNE configuration instructions on GitHub Issue #29. Configuration instructions for mac OS are still a work in progress.
- Make improvements to flowAI package to improve compatibility with CytoExploreR. FlowAI can be used when loading samples in
cyto_setup()by settingclean = TRUEor manually applied downstream usingcyto_clean(). - Add back Appveyor CI to build on windows.
- Update custom plotting functions (
cyto_plot_save,cyto_plot_layout,cyto_plot_customandcyto_plot_complete) to allow complex layouts. Layouts must now be supplied to these functions either as a vector or matrix. cyto_plot_completeno longer closes the RStudio or X11 graphics devices.- Add new
marginsargument tocyto_plotto allow customization of plot margins. - Fix
overlay = "children"when plotting GatingSet objects withcyto_plot.
- Add ability to control plotting order in
cyto_plotwhen using thegroup_byargument. - Add new
data_editorfunction to bring excel-like features to all context menus and data editors. - Add viewer argument to
cyto_spillover_editto allow it to be launched in the RStudio viewer pane (if desired).
- Remove requirement for GUI device in
cyto_gate_drawandcyto_gate_edit. Users can now draw gates directly on the RStudio graphics device. - Add support for changing gate point and lines colours within
cyto_gate_drawandcyto_gate_edit. - improve appearance of 1-D interval gates in
cyto_gate_draw. - Add dependency for openCyto >= 1.25.2 to support gating of empty populations.
- Add Dockerfile and Makefile to build CytoExploreR docker images for reproducible data analysis. Docker images can be pulled from docker hub at
dhammill/cytoexplorer.
- Update installation instructions on website following in changes in RGLab default branches.
- Fix sample grouping when no experiment details are added to samples.
- Resort to machine axes limits when no events are present for plotting.
- Improve handling of multiple compensation controls for the same channel in
cyto_spillover_compute(). Now the control with the best signal will be used for the calculation. - Add support to
cyto_map()for FIt-SNE dimensionality reduction. Updatecyto_map()documentation to include references for each of the supported dimensionality reduction algorithms. - Fix gating of empty populations to prevent dummy gates being returned by openCyto.
- Frequency statistics for empty populations are now displayed as zero instead of NaN.
- Improve handling of arguments within cyto_plot for better user experience.
- Fix errors for cyto_spillover_compute and cyto_spillover_spread_compute on mac OS.
cyto_setup()now accepts filenames through markers and details arguments.
- Added a
NEWS.mdfile to track changes to the package.