SIGNIFICANT USER-VISIBLE CHANGES

• fetch_data("Visium_SPG_AD_Visium_wholegenome_spe""), fetch_data("Visium_SPG_AD_Visium_targeted_spe"), fetch_data("Visium_SPG_AD_Visium_wholegenome_pseudobulk_spe"), and fetch_data("Visium_SPG_AD_Visium_wholegenome_modeling_results") have been added. Use this to access data from the https://github.com/LieberInstitute/Visium_SPG_AD project.

SIGNIFICANT USER-VISIBLE CHANGES

BUG FIXES

SIGNIFICANT USER-VISIBLE CHANGES

• gene_set_enrichment() now internally uses fisher.test(alternative = "greater") to test for odds ratios greater than 1. Otherwise odds ratios of 0 could be significant.

SIGNIFICANT USER-VISIBLE CHANGES

NEW FEATURES

BUG FIXES

• Fixed a bug related to edgeR::filterByExpr() inside of registration_pseudobulk().
• Moved the min_ncells filtering step to registration_pseudobulk() rather than registration_wrapper() since you should drop low ncells before using edgeR::filterByExpr().

BUG FIXES

• Fixed some bugs in registration_stats_anova() in cases where we only had two different unique values to compute F-statistics with, when we need at least
• Made some parts of registration_stats_anova() and registration_stats_pairwise() more flexible.
• registration_model() now provides a more informative error message when you have an empty factor level, thus leading to a non-full rank model matrix.

NEW FEATURES

• Added functions for computing the modeling statistics used by the spatial registration process. See registration_wrapper() and related functions.
• Added a function for using the output of layer_stat_cor() and for labeling the clusters. This can help interpret the spatial registration results. See annotate_registered_clusters() for more details.

BUG FIXES

• Fixed bugs in gene_set_enrichment() for reverse = TRUE reported by
• Added a reverse option on the shiny app under the gene set enrichment tab, that we tested with the example spe data.

SIGNIFICANT USER-VISIBLE CHANGES

• Improved the automatic color palette selector when you switch discrete variables. It also now supports the ManualAnnotation option.
• Discrete variable (cluster) legend is no longer duplicated under the clusters interactive tab.
• You can now search the model test, which helps if you have lots of tests to choose from (this most likely occurs when you are looking at the pairwise results).

SIGNIFICANT USER-VISIBLE CHANGES

• Made the shiny application more memory efficient in different areas.
• Changed the default point_size from 1.25 to 2.
• Added the option to show or hide the spatial images on the grid panels in the shiny web application. Turn off by default since it is more efficient.

BUG FIXES

1. Now the gene selector changes automatically when you change the ‘model results’ (model type) or ‘model test’ inputs. The gene selector is now only shown inside the ‘model boxplots’ panel since it only affects that one.

BUG FIXES

BUG FIXES

SIGNIFICANT USER-VISIBLE CHANGES

• Documentation of the layer-level data panel at run_app() has been significantly increased. You can now also visualize more than 2 reduced dimensions computed on the pseudo-bulk level data (layer-level for the Maynard et al, Nature Neurosci, 2021 data).
• Users can now control the font and point size on the reduced dimension plots, as well as the overall font size on the model boxplots.
• Image edit scenarios you might be interested in for having a uniform color background image are now documented; for example if you want a white or black background, or actually any valid R color name or color HEX value.

SIGNIFICANT USER-VISIBLE CHANGES

• run_app() now offers the option to chose any of the paletteer::paletteer_d color palettes for discrete variables.
• Polychrome has been replaced as a dependency by paletteer. Note that Polychrome::palette36 is still the default.
• run_app() now looks for columns that end with ’_colors’ in their name which can be used to pre-specify colors for any companion variables. For example if you have spe$my_groups and spe$my_groups_colors then the second one can specify the colors that will be used for visualizing spe\$my_groups. This makes specifying default colors more flexible than before, and the user is still free to change them if necessary.

BUG FIXES

• Fix bugs in layer_boxplot() where it was too specific to the Maynard et al 2021 data. We have made it more flexible now.
• Made the y-axis space more dynamic in gene_set_enrichment_plot() and layer_matrix_plot().

BUG FIXES

• Fixed a bug in sig_genes_extract() when there’s only one set of t-statistics or F statistics to extract.

SIGNIFICANT USER-VISIBLE CHANGES

• The visualization functions vis_*() of SpatialLIBD in this version match the Bioconductor 3.15 version of SpatialExperiment. Note that if you used SpatialExperiment::read10xVisium(), the names of the spatial coordinates changed at https://github.com/drighelli/SpatialExperiment/commit/6710fe8b0a7919191ecce989bb6831647385ef5f and thus you might need to switch them back if you created your SpatialExperiment object before this change. You can do so with spatialCoordsNames(spe) <- rev(spatialCoordsNames(spe)). read10xVisiumWrapper() uses SpatialExperiment::read10xVisium() internally, so this change on SpatialExperiment would then also affect you.

NEW FEATURES

• Now layer_stat_cor() has the top_n argument which can be used for subsetting the marker genes prior to computing the correlation as part of the spatial registration process.

NEW FEATURES

NEW FEATURES

BUG FIXES

• Fixed a bug where the using the left-mouse click was not working for annotating individual spots under the “gene (interactive)” tab.

NEW FEATURES

• vis_gene_p(), vis_clus_p() and all related functions now have an argument point_size which lets you control how big the points are plotted. This can be useful for visualization purposes.
• The shiny app now has an input controlling the point size. If you increase it to say 5, then if you zoom in the clusters (interactive) panel, you can see larger spots when zooming in.
• These features are related to https://github.com/LieberInstitute/spatialLIBD/issues/28 although the spot diameter is still not the true spot diameter. However, now you have more flexibility for visualizing the spots.

NEW FEATURES

BUG FIXES

• vis_gene() and vis_grid_gene() now support geneids that are found in the rownames(spe). This makese these functions more flexible.
• vis_grid_gene() and vis_grid_clus() now have the sample_order argument which gives you more control in case you want to plot a subset of samples. This should also reduced the memory required as discovered at https://github.com/LieberInstitute/spatialDLPFC/issues/45.

NEW FEATURES

BUG FIXES

• Fixed an issue introduced by newer versions of shiny. This version of spatialLIBD works with shiny version 1.7.1, though it’s likely backwards compatible. Resolves https://github.com/LieberInstitute/spatialLIBD/issues/24.
• Fix an issue where as.data.frame(colData(spe)) uses check.names = TRUE by default and then changes the column names unintentionally.

NEW FEATURES

• Added read10xVisiumWrapper() and related functions that make it easier to read in the SpaceRanger output files and launch a shiny web application using run_app(). These new functions read in the analysis output from SpaceRanger by 10x Genomics, in particular, the clustering and dimension reduction (projection) results.

SIGNIFICANT USER-VISIBLE CHANGES

• spatialLIBD has been updated to work with SpatialExperiment version 1.1.701 which will be released as part of Bioconductor 3.13. This changes internal code of spatialLIBD which will work with any objects created with SpatialExperiment version 1.1.700.

SIGNIFICANT USER-VISIBLE CHANGES

SIGNIFICANT USER-VISIBLE CHANGES

• We now use plotly::toWebGL() to make the web application more responsive.

SIGNIFICANT USER-VISIBLE CHANGES

• The documentation and help messages shown in the web application have been revamped and improved.

NEW FEATURES

• We added a new vignette that shows how you can use spatialLIBD with any 10x Genomics Visium dataset processed with spaceranger. The vignette uses the publicly available human lymph node example from the 10x Genomics website.

NEW FEATURES

• Overall the package has been updated to use SpatialExperiment version 1.1.427 available on Bioconductor 3.13 (bioc-devel). Several functions were re-named such as sce_image_gene_p() now has a shorter name vis_gene_p(). This update also changes these visualization functions to ONLY support SpatialExperiment objects instead of the original modified SingleCellExperiment objects.
• Updated citation information to reflect that https://doi.org/10.1038/s41593-020-00787-0 is now public. Also added a link on the README to https://doi.org/10.6084/m9.figshare.13623902.v1 for the manuscript high resolution images.

NEW FEATURES

• The functions sce_image_gene_p(), sce_image_gene(), sce_image_grid(), sce_image_grid_gene(), sce_image_clus(), sce_image_clus_p(), geom_spatial() now work with VisiumExperiment objects thanks to the new function read_image() and ve_image_colData(). This work was done by Brenda Pardo and Leonardo.

NEW FEATURES

• fetch_data() takes the data from sce object and creates a VisiumExperiment object containing these data thanks to the function sce_to_ve(). VisiumExperiment object can be obtained with fetch_data("ve"). This work was done by Brenda Pardo and Leonardo.

NEW FEATURES

• fetch_data() now uses BiocFileCache() when downloading the data from Dropbox.

SIGNIFICANT USER-VISIBLE CHANGES

• Added the function enough_ram() which is used to control the execution of examples. If it fails when using fetch_data("sce") then fetch_data() will show a warning.
• fetch_data(type = "sce_example") is now supported and used visibly in the vignette, eliminating the need for eval = FALSE chunks. This should enable testing the vignette code on the Bioconductor Single Package Builder on Windows (max 2.5 GB of RAM available).

BUG FIXES

• Fixed the example in get_colors().
• Fixed layer_stat_cor_plot() for when min and/or max are specified.

SIGNIFICANT USER-VISIBLE CHANGES

BUG FIXES

BUG FIXES

SIGNIFICANT USER-VISIBLE CHANGES

BUG FIXES

SIGNIFICANT USER-VISIBLE CHANGES

SIGNIFICANT USER-VISIBLE CHANGES

BUG FIXES

SIGNIFICANT USER-VISIBLE CHANGES

• Add mirrors for the shiny app and change the main location.

SIGNIFICANT USER-VISIBLE CHANGES

• Make fetch_data() more flexible. Should now work when the data is absent.

BUG FIXES

• Fix Kristen’s name on the vignette
• Add the same welcome information to the top of the vignette, since this will be what Bioconductor users see first. Basically, we have made sure that users will see the same information first regardless if they find the package README, open the shiny app, or find the package vignette.

SIGNIFICANT USER-VISIBLE CHANGES

• Further refine the READMEs (pkg and shiny). They now include the list of links to the raw 10x Genomics files as well as a short description of the project at the top. This was in response to feedback by Andrew Jaffe.

SIGNIFICANT USER-VISIBLE CHANGES

• Update main package READMEs to reflect the changes to the shiny web app README.md.

NEW FEATURES

• Added Kristen R Maynard to the DESCRIPTION file.
• Improved the shiny app page footer.
• Moved around the documentation and added a new main tab with an overview in response to the feedback by Stephanie Hicks.

NEW FEATURES

• Added a NEWS.md file to track changes to the package.
• First full version of the package to be submitted to Bioconductor. Note that the ExperimentHub::ExperimentHub() functionality won’t work until they approve the package. However, for now fetch_data() has a backup mechanism in place.
• Submitted to Bioconductor here.