2022-01-03
- Fix
parse_composite_infoto work with older composite images that are missing ImageDescription (akoyabio/phenoptrReports#52) - Correctly parse phenotype expressions containing slashes (#18)
- Tighten up the column exclusion criteria for
read_cell_seg_datawithcol_select="phenoptrReports"(#16) - Update tests to work with testthat 3.1.
2021-08-24
- Add
read_compositesandread_composite_infoto read and parse metadata in inForm composite images.
2021-08-03
Misc:
- Update dependencies to modern versions
- Fix for bug in readr 2.0.0
2021-06-01
Changes to read_cell_seg_data:
- Add a
col_selectparameter to support reading only selected fields, with a'phenoptrReports'option to read only fields needed byphenoptrReports. - Use
vroom::vroom()instead ofreadr::read_tsvfor speed and support ofcol_select. - For an export file containing all inForm fields,
read_cell_seg_data(csd_path, col_select='phenoptrReports')can be 4-5x faster and use 75% less memory for the results, compared to the previous version.
Spatial distribution report:
- Fix report generation to work when paths contain spaces.
Misc:
- Fix
select_rowsto always returnFALSEinstead ofNA. - Update to work with CRAN release of tiff 0.1-8
- Update to work with (and require) spatstat 2.0.0
- Require R 4.0.0 or greater for compatibility with latest rtree
2020-11-11
- Improved the way
read_cell_seg_datadetermines column types to prevent errors in some edge cases. - Fixed
make_pppto work correctly when given compound phenotypes such as "CD8+/PD-L1+"
2020-08-22
- Add
make_pppfunction to create marked point patterns. parse_phenotypesmakes nicer names for expression-based phenotypes.- Add
phenotype_columnsin support of akoyabio/phenoptrReports#36. - Add
read_field_infoandget_map_pathfunctions.
2020-06-02
Fix to work with dplyr 1.0.0.
2020-04-21
- Avoid deprecation warning for
expand_scalewith ggplot2 version 3.3.0
2020-02-28
- Make
read_cell_datamore robust against data with comma as the decimal separator. - Better documentation and error messages in
count_touching_cells_fast.
2019-10-22
- Add
count_touching_cells_fastfor phenoptrReports spatial map viewer. - Don't return NA values from
select_rows(); returnFALSEinstead. - Now requires tidyr >= 1.0.0.
2019-08-07
- Add
annotation_raster_nativefor faster plotting with background images.
2019-06-11
- Remove the explicit dependency on
phenoptrReportsto avoid installation pain.phenoptrReportsis still needed to build the vignettes and to run a few of the examples. parse_phenotypesandvalidate_phenotype_definitionssupport expressions in phenotype definitions.
2019-05-31
- The spatial analysis report now uses the full-intensity composite image as its background image. Connecting lines and the scale bar are white to be visible against the dark background of the composite image.
Bug fixes:
- Fix
density_bandsto work with cell seg data in microns with slide origin (#10).
2019-05-10
New feature (and breaking change):
- The nearest neighbor functions
compute_all_nearest_distanceandfind_nearest_distancenow create columns containing the Cell ID of the nearest cell, as well as the columns with the actual distance. This column can be used to find the locations of nearest cells and to find mutual nearest neighbors. The "Computing inter-cell distances" tutorial shows some uses of this data.
Bug fixes:
read_cell_seg_datarecognizes and correctly reads inForm data which uses comma as the decimal separator (#8).- Fix SpatialDistributionReport to work with more than 8 phenotypes (#6).
count_touching_cellsignores phenotype pairs of self to self with a warning because the touching algorithm does not handle this case (#7).
2019-04-22
- Remove the scary
Failed with error: ‘there is no package called ‘rtree’’message thatrequireNamespace('rtree')generates (#5).
2019-04-12
New features:
- Add fast implementation of
count_within_manyandcount_within_batchusingakoyabio/rtreepackage. - Add fast
count_within_detailto give per-cell counts.
Bug fixes:
- Fix
get_field_infoto work with the standard (CRAN)tiffpackage. count_withinand related functions returnNAforwithin_meanwhen there are nofromcells (rather than a mean of 0).- Update
spatial_distribution_reportvignette and example to usephenoptrExamples, which contains the required component data file (#3). - Fix problem in
count_touching_cellswhen there is exactly one touching cell pair (#4)
2019-03-03
- Add
count_within_manyin support of phenoptrReports. count_withindoes not count self when 'from' and 'to' phenotypes are the same.- Add
field_column(moved from phenoptrReports) andvalidate_phenotypes. - Fix
compute_all_nearest_distanceto recognize "Annotation ID" as a field name.
2019-02-08
- Update
find_nearest_distance,compute_all_nearest_distance,density_at_distance,density_bands,count_withinandspatial_distribution_reportto work with consolidated data fromphenoptrReports(#1).
Bug fixes
- Change
sq micronsandsq mmtosquare micronsandsquare mmto match inForm output.
2018-12-27
spatial_distribution_reportworks correctly with cell seg data in microns. To do so, it requires a component data file for the target field. Image dimensions are taken from that file.count_touching_cellsworks correctly when cell seg data is in microns.- Require readr version 1.2.0 or higher to avoid incorrectly reading numeric data columns as integer.
- Add a simple data quality check to
read_cell_seg_data#9 count_withinwon't complain if the data doesn't have aSample Namecolumn.- More accurate image location from component file if PerkinElmer tiff library is available.
2018-10-29
- Update link to Phenoptics home page.
2018-09-28
- Remove import dependency on tidyverse. Examples and vignettes use dplyr, ggplot2 and magrittr instead. #6
2018-09-28
- New
parse_phenotypesfunction simplifies creation of selectors forselect_rows. select_rowsrecognizes the column format of phenotype-per-marker data.select_rowstreats aNAselector as "select all". This is helpful in lists of selectors.read_cell_seg_dataattempts to skip microns conversion if it was already done.
2018-07-11
- Fix
count_touching_cellsto work with two-pixel-wide membrane map. #8
2018-04-24
- Fix
count_within_batchto work with cell seg files which don't haveSlide IDfields.
- Add
density_at_distanceanddensity_bandsto estimate cell density at a distance from a boundary.
- Add
pixels_per_micron="auto"option toread_cell_seg_data(). - Supports tiled component files using the PerkinElmer fork of the tiff package.
- Faster count_touching_cells when EBImage 4.19.9 is available.
- Renamed the package from
informrtophenoptr. - This version changed the order of arguments to
subset_distance_matrixin a backwards-incompatible way. This was done to put thecsdparameter first, matching other functions with acsdparameter.
spatial_distribution_reportcreates an HTML report showing the location and nearest-neighbor relations of cells in a single field.count_touching_cellsuses morphological analysis of nuclear and membrane segmentation maps to find touching cells of paired phenotypes.read_componentsreads component image files.count_withinandcount_within_batchcount the number offromcells having atocell within a given radius.list_cell_seg_fileslists all cell seg data files in a folder.- Added vignettes
- "Reading and Exploring inForm Tables"
- "Reading and Displaying inForm Image Files"
- "Computing Inter-cellular Distances"
- "Find and count touching cells"
- "Selecting cells within a cell segmentation table"
- Better handling of
NAvalues in distance columns of cell seg tables. PreviouslyNAvalues could cause the column to be read as character data.
read_mapswill find the correct path when given a cell seg table path.- Many documentation improvements.
- Internal cleanup using
lintrandgoodpractices. - zlib license
compute_all_nearest_distanceis a convenience function which reads a cell seg table, addsDistance to <phenotype>columns, and writes it out again.