{ "_id": "6a1f5d00b401979e7342d69b", "Type": "Package", "Package": "ggbrain", "Title": "Create Images of Volumetric Brain Data in NIfTI Format Using\n'ggplot2' Syntax", "Version": "0.9.2", "Date": "2025-11-25", "Authors@R": "person(\"Michael\", \"Hallquist\", , \"michael.hallquist@gmail.com\", role = c(\"aut\", \"cre\"),\ncomment = c(ORCID = \"0000-0001-5894-8038\"))", "Maintainer": "Michael Hallquist ", "Description": "A 'ggplot2'-consistent approach to generating 2D displays\nof volumetric brain imaging data. Display data from multiple\nNIfTI images using standard 'ggplot2' conventions such scales,\nlimits, and themes to control the appearance of displays. The\nresulting plots are returned as 'patchwork' objects, inheriting\nfrom 'ggplot', allowing for any standard modifications of\ndisplay aesthetics supported by 'ggplot2'.", "URL": "https://michaelhallquist.github.io/ggbrain/", "BugReports": "https://github.com/michaelhallquist/ggbrain/issues", "License": "GPL (>= 3)", "Encoding": "UTF-8", "Roxygen": "list(markdown = TRUE, r6 = TRUE)", "RoxygenNote": "7.3.3", "VignetteBuilder": "knitr", "Config/testthat/edition": "3", "Config/pak/sysreqs": "libfftw3-dev libglpk-dev libicu-dev libjpeg-dev\nlibpng-dev libtiff-dev libxml2-dev libx11-dev", "Repository": "https://michaelhallquist.r-universe.dev", "Date/Publication": "2026-06-02 20:10:24 UTC", "RemoteUrl": "https://github.com/michaelhallquist/ggbrain", "RemoteRef": "HEAD", "RemoteSha": "64d7a09ac6caec9f4b33876d8e8e029e12982f88", "NeedsCompilation": "yes", "Packaged": { "Date": "2026-06-02 22:33:57 UTC", "User": "root" }, "Author": "Michael Hallquist [aut, cre] (ORCID:\n)", "MD5sum": "20343da513561522c8201177d8e43d16", "_user": "michaelhallquist", "_type": "src", "_file": "ggbrain_0.9.2.tar.gz", "_fileid": "3168d23103980ac439d6639ca15be89011e0dddf463ecbb4608fba04a6534d00", "_filesize": 5535902, "_sha256": "3168d23103980ac439d6639ca15be89011e0dddf463ecbb4608fba04a6534d00", "_created": "2026-06-02T22:33:57.000Z", "_published": "2026-06-02T22:45:20.536Z", "_distro": "noble", "_jobs": [ { "job": 79186283072, "time": 248, "config": "linux-devel-arm64", "r": "4.7.0", "check": "OK", "artifact": "7371494342" }, { "job": 79186283070, "time": 265, "config": "linux-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "7371498212" }, { "job": 79186283082, "time": 249, "config": "linux-release-arm64", "r": "4.6.0", "check": "OK", "artifact": "7371494649" }, { "job": 79186283068, "time": 249, "config": "linux-release-x86_64", "r": "4.6.0", "check": "OK", "artifact": "7371494028" }, { "job": 79186283084, "time": 178, "config": "macos-oldrel-arm64", "r": "4.5.3", "check": "OK", "artifact": "7371470686" }, { "job": 79186283063, "time": 539, "config": "macos-oldrel-x86_64", "r": "4.5.3", "check": "OK", "artifact": "7371559306" }, { "job": 79186283080, "time": 185, "config": "macos-release-arm64", "r": "4.6.0", "check": "OK", "artifact": "7371472532" }, { "job": 79186283077, "time": 597, "config": "macos-release-x86_64", "r": "4.6.0", "check": "OK", "artifact": "7371574207" }, { "job": 79185501749, "time": 338, "config": "source", "r": "4.6.0", "check": "OK", "artifact": "7371427672" }, { "job": 79186283050, "time": 168, "config": "wasm-release", "r": "4.6.0", "check": "OK", "artifact": "7371473070" }, { "job": 79186283076, "time": 236, "config": "windows-devel", "r": "4.7.0", "check": "OK", "artifact": "7371491022" }, { "job": 79186283074, "time": 207, "config": "windows-oldrel", "r": "4.5.3", "check": "OK", "artifact": "7371483152" }, { "job": 79186283060, "time": 250, "config": "windows-release", "r": "4.6.0", "check": "OK", "artifact": "7371494138" } ], "_buildurl": "https://github.com/r-universe/michaelhallquist/actions/runs/26851807627", "_status": "success", "_host": "GitHub-Actions", "_upstream": "https://github.com/michaelhallquist/ggbrain", "_commit": { "id": "64d7a09ac6caec9f4b33876d8e8e029e12982f88", "author": "Michael Hallquist ", "committer": "Michael Hallquist ", "message": "Support bisided clustering by default; avoid changing underlay to bisided if it contains negative values\n", "time": 1780431024 }, "_maintainer": { "name": "Michael Hallquist", "email": "michael.hallquist@gmail.com", "login": "michaelhallquist", "description": "", "uuid": 284491, "orcid": "0000-0001-5894-8038" }, "_registered": true, "_dependencies": [ { "package": "R", "version": ">= 3.5.0", "role": "Depends" }, { "package": "Rcpp", "role": "LinkingTo" }, { "package": "RcppArmadillo", "role": "LinkingTo" }, { "package": "Matrix", "role": "Imports" }, { "package": "checkmate", "role": "Imports" }, { "package": "data.table", "role": "Imports" }, { "package": "dplyr", "role": "Imports" }, { "package": "ggplot2", "role": "Imports" }, { "package": "ggnewscale", "role": "Imports" }, { "package": "ggrepel", "role": "Imports" }, { "package": "glue", "role": "Imports" }, { "package": "imager", "role": "Imports" }, { "package": "patchwork", "role": "Imports" }, { "package": "rlang", "role": "Imports" }, { "package": "tibble", "role": "Imports" }, { "package": "tidyr", "role": "Imports" }, { "package": "tidyselect", "role": "Imports" }, { "package": "R6", "role": "Imports" }, { "package": "Rcpp", "role": "Imports" }, { "package": "RNifti", "role": "Imports" }, { "package": "knitr", "role": "Suggests" }, { "package": "rmarkdown", "role": "Suggests" }, { "package": "testthat", "version": ">= 3.0.0", "role": "Suggests" } ], "_owner": "michaelhallquist", "_selfowned": true, "_usedby": 0, "_updates": [ { "week": "2025-34", "n": 1 }, { "week": "2025-48", "n": 1 }, { "week": "2025-49", "n": 9 }, { "week": "2025-50", "n": 1 }, { "week": "2026-23", "n": 1 } ], "_tags": [ { "name": "0.9.1", "date": "2025-08-22" } ], "_stars": 3, "_contributors": [ { "user": "michaelhallquist", "count": 130, "uuid": 284491 } ], "_userbio": { "uuid": 284491, "type": "user", "name": "michaelhallquist" }, "_downloads": { "count": 534, "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/ggbrain" }, "_devurl": "https://github.com/michaelhallquist/ggbrain", "_pkgdown": "https://michaelhallquist.github.io/ggbrain/", "_searchresults": 18, "_topics": [ "cpp" ], "_rbuild": "4.6.0", "_assets": [ "extra/citation.cff", "extra/citation.html", "extra/citation.json", "extra/citation.txt", "extra/contents.json", "extra/ggbrain.html", "extra/NEWS.html", "extra/NEWS.txt", "extra/readme.html", "extra/readme.md", "manual.pdf" ], "_homeurl": "https://github.com/michaelhallquist/ggbrain", "_realowner": "michaelhallquist", "_cranurl": true, "_releases": [ { "version": "0.8.0", "date": "2022-11-04" }, { "version": "0.8.1", "date": "2023-03-21" }, { "version": "0.9.0", "date": "2025-03-22" }, { "version": "0.9.1", "date": "2025-08-22" } ], "_exports": [ "annotate_coordinates", "annotate_crosshairs", "annotate_orientation", "annotate_slice", "cluster_slices", "define", "geom_brain", "geom_brain_clusterized", "geom_outline", "geom_region_label", "geom_region_label_repel", "geom_region_text", "geom_region_text_repel", "ggbrain", "ggbrain_images", "ggbrain_label", "ggbrain_layer", "ggbrain_layer_brain", "ggbrain_layer_outline", "ggbrain_panel", "ggbrain_plot", "images", "integer_breaks", "montage", "nn_impute", "range_breaks", "render", "scale_fill_bisided", "slices", "target_resolution" ], "_help": [ { "page": "plus-.ggb", "title": "addition operator for ggb object to support ggplot-like syntax", "topics": [ "+.ggb" ] }, { "page": "plus-.ggbrain_images", "title": "summary S3 method for ggbrain_images objects addition operator for combining ggbrain_images objects", "topics": [ "+.ggbrain_images" ] }, { "page": "annotate_coordinates", "title": "Adds the coordinate labels to each panel based on the location of the slice along the slicing axis (e.g., z = 15)", "topics": [ "annotate_coordinates" ] }, { "page": "annotate_crosshairs", "title": "Annotate crosshairs at user-specified world (xyz) coordinates", "topics": [ "annotate_crosshairs" ] }, { "page": "annotate_orientation", "title": "Annotate orientation labels (L/R/A/P/S/I) on each panel using NIfTI header info", "topics": [ "annotate_orientation" ] }, { "page": "annotate_slice", "title": "Adds custom annotations to a single panel on the ggbrain plot", "topics": [ "annotate_slice" ] }, { "page": "cluster_slices", "title": "Find slice locations based on cluster centers of mass in a 3D brain image", "topics": [ "cluster_slices" ] }, { "page": "count_neighbors", "title": "This function counts the number of neighboring/touching pixels in a 2D binary image", "topics": [ "count_neighbors" ] }, { "page": "define", "title": "Adds contrast definitions to the ggbrain plot", "topics": [ "define" ] }, { "page": "fill_from_edge", "title": "This function finds holes by flood filling TRUE into a 2D binary image, starting from the edge", "topics": [ "fill_from_edge" ] }, { "page": "find_threads", "title": "This function finds 'threads' hanging off of the edges of blobs in an image, allowing the user to trim them", "topics": [ "find_threads" ] }, { "page": "flood_fill", "title": "This function flood fills a binary image with TRUE for any value of FALSE", "topics": [ "flood_fill" ] }, { "page": "geom_brain", "title": "Adds a raster layer to the ggbrain plot, displaying pixels from the specified layer definition", "topics": [ "geom_brain" ] }, { "page": "geom_brain_clusterized", "title": "Clusterize a contrast/image and display clusters as categorical fill", "topics": [ "geom_brain_clusterized" ] }, { "page": "geom_outline", "title": "Adds an outline layer to the ggbrain plot, displaying outlines from the non-missing pixels in the specified layer definition", "topics": [ "geom_outline" ] }, { "page": "geom_region_label", "title": "Variant of geom_label used for plotting region labels on slices", "topics": [ "geom_region_label" ] }, { "page": "geom_region_label_repel", "title": "Variant of geom_label_repel used for plotting region labels on slices with separation from other labels", "topics": [ "geom_region_label_repel" ] }, { "page": "geom_region_text", "title": "Variant of geom_text used for plotting region labels on slices", "topics": [ "geom_region_text" ] }, { "page": "geom_region_text_repel", "title": "Variant of geom_text_repel used for plotting region labels on slices with separation from other labels", "topics": [ "geom_region_text_repel" ] }, { "page": "ggbrain", "title": "create ggb container object for a given plot", "topics": [ "ggbrain" ] }, { "page": "ggbrain_images", "title": "R6 class for compiling images to render in ggplot", "topics": [ "ggbrain_images" ] }, { "page": "ggbrain_label", "title": "R6 class for adding labels to a ggbrain_panel", "topics": [ "ggbrain_label" ] }, { "page": "ggbrain_layer", "title": "R6 class for a single layer of a ggbrain panel", "topics": [ "ggbrain_layer" ] }, { "page": "ggbrain_layer_brain", "title": "R6 class for a single layer of a ggbrain panel using fill geom", "topics": [ "ggbrain_layer_brain" ] }, { "page": "ggbrain_layer_outline", "title": "R6 class for a single layer of a ggbrain panel using outline geom", "topics": [ "ggbrain_layer_outline" ] }, { "page": "ggbrain_panel", "title": "R6 class for a single panel of a ggbrain image", "topics": [ "ggbrain_panel" ] }, { "page": "ggbrain_plot", "title": "An R6 class for constructing a ggbrain plot from a ggbrain_slices object", "topics": [ "ggbrain_plot" ] }, { "page": "ggplot_add.ggbrain_label", "title": "S3 method to support adding ggbrain_label objects to an existing ggplot object", "topics": [ "ggplot_add.ggbrain_label" ] }, { "page": "ggplot_add.ggbrain_layer", "title": "S3 method to support adding ggbrain_layer objects to an existing ggplot object", "topics": [ "ggplot_add.ggbrain_layer" ] }, { "page": "ggplot_add.ggbrain_panel", "title": "S3 method to support adding ggbrain_layer objects to an existing ggplot object", "topics": [ "ggplot_add.ggbrain_panel" ] }, { "page": "images", "title": "Add images to a ggbrain object", "topics": [ "images" ] }, { "page": "integer_breaks", "title": "breaks function to encourage integer-valued breaks, based on input from pretty", "topics": [ "integer_breaks" ] }, { "page": "montage", "title": "Convenience function to add many slices in a montage along one of the 3D planes", "topics": [ "montage" ] }, { "page": "nn_impute", "title": "Imputes missing values in a 2D matrix based on the nearest non-missing neighbors in a given radius", "topics": [ "nn_impute" ] }, { "page": "plot.ggb", "title": "S3 method to allow for plot(x) syntax with ggbrain (ggb) objects", "topics": [ "plot.ggb" ] }, { "page": "plot.ggbrain_panel", "title": "S3 method to allow for plot() syntax with ggbrain_panel objects", "topics": [ "plot.ggbrain_panel" ] }, { "page": "plot.ggbrain_patchwork", "title": "S3 method to allow for plot() syntax with rendered ggbrain patchwork objects", "topics": [ "plot.ggbrain_patchwork", "print.ggbrain_patchwork" ] }, { "page": "plot.ggbrain_plot", "title": "S3 method to allow for plot() syntax with ggbrain_panel objects", "topics": [ "plot.ggbrain_plot" ] }, { "page": "range_breaks", "title": "breaks function for including min + max with labels, and a few unlabeled ticks in between", "topics": [ "range_breaks" ] }, { "page": "render", "title": "Function to convert 'ggb' object to ggplot/patchwork object", "topics": [ "render" ] }, { "page": "render.ggb", "title": "S3 method to allow for render(x) syntax with ggbrain (ggb) objects", "topics": [ "render.ggb" ] }, { "page": "scale_fill_bisided", "title": "scale for plotting separate color gradients for positive and negative values", "topics": [ "scale_fill_bisided" ] }, { "page": "slices", "title": "Adds slices to the ggbrain plot, including additional panel aesthetics", "topics": [ "slices" ] }, { "page": "target_resolution", "title": "Set the target resolution for resampling slices in a ggbrain plot", "topics": [ "target_resolution" ] } ], "_readme": "https://github.com/michaelhallquist/ggbrain/raw/HEAD/README.md", "_rundeps": [ "backports", "bmp", "checkmate", "cli", "cpp11", "data.table", "digest", "downloader", "dplyr", "farver", "generics", "ggnewscale", "ggplot2", "ggrepel", "glue", "gtable", "igraph", "imager", "isoband", "jpeg", "labeling", "lattice", "lifecycle", "magrittr", "Matrix", "patchwork", "pillar", "pkgconfig", "png", "purrr", "R6", "RColorBrewer", "Rcpp", "RcppArmadillo", "readbitmap", "rlang", "RNifti", "S7", "scales", "stringi", "stringr", "tibble", "tidyr", "tidyselect", "tiff", "utf8", "vctrs", "viridisLite", "withr" ], "_sysdeps": [ { "shlib": "libstdc++", "package": "libstdc++6", "source": "gcc", "version": "14.2.0-4ubuntu2~24.04.1", "name": "c++", "homepage": "http://gcc.gnu.org/", "description": "GNU Standard C++ Library v3" } ], "_vignettes": [ { "source": "ggbrain_aesthetics.Rmd", "filename": "ggbrain_aesthetics.html", "title": "Aesthetic refinements of ggbrain plots", "author": "Michael Hallquist", "engine": "knitr::rmarkdown", "headings": [ "Images used in this demo", "Adjustments to the appearance of image layers", "Removing small specks (remove_specks)", "Filling small holes (fill_holes)", "Trimming threads (trim_threads)", "Combining image cleaning operations", "Working with color scales", "Custom color scales", "Bisided color scales", "Working with categorical images and labels", "Mapping fills to label columns", "Combining fills with outlines", "Adding region labels", "Using geom_region_label_repel", "Adding annotations", "Coordinate annotations", "Orientation annotations", "Crosshair annotations", "Creating reusable plot components", "Combining ggbrain plots with patchwork", "Basic patchwork combinations", "Advanced layout with shared legend", "Saving ggbrain plots to file", "Filtering images for focused displays", "Target resolution for higher quality displays", "Other considerations", "Resampling images externally", "The hierarchy of a ggbrain plot", "Tips for publication-quality figures" ], "created": "2022-10-12 22:15:30", "modified": "2025-12-08 15:41:51", "commits": 7 }, { "source": "ggbrain_introduction.Rmd", "filename": "ggbrain_introduction.html", "title": "Introduction to ggbrain", "author": "Michael Hallquist", "engine": "knitr::rmarkdown", "headings": [ "Images that will be used in the demo", "Installing the package", "Building a ggbrain plot layer by layer", "Add images", "Add slices", "Adding slices by spatial position", "Adding slices by quantile", "Adding slices with additional aesthetic details", "Adding montages", "Automatically locating clusters and outlines", "Add brain overlay layers", "Defining an image layer", "Defining subset layers", "Defining a contrast layer", "Add outlines", "Clusterized categorical layers", "Converting to a ggplot object and displaying the plot", "Saving ggbrain plots to file", "Next steps" ], "created": "2022-07-28 16:50:13", "modified": "2025-12-06 22:19:59", "commits": 21 }, { "source": "ggbrain_labels.Rmd", "filename": "ggbrain_labels.html", "title": "Working with annotations and labels in ggbrain", "author": "Michael Hallquist", "engine": "knitr::rmarkdown", "headings": [ "Categorical images in ggbrain", "Mapping image values to labels", "Combining filled areas with outlines", "Combining quantitative layers with labels", "Adding annotations", "Adding labels systematically" ], "created": "2023-06-16 19:39:12", "modified": "2025-03-21 16:42:18", "commits": 9 } ], "_score": 5.607455023214668, "_indexed": true, "_nocasepkg": "ggbrain", "_universes": [ "michaelhallquist" ], "_binaries": [ { "r": "4.7.0", "os": "linux", "version": "0.9.2", "date": "2026-06-02T22:37:20.000Z", "distro": "noble", "arch": "aarch64", "commit": "64d7a09ac6caec9f4b33876d8e8e029e12982f88", "fileid": "c6ce93276474393329f5ed69e111425cd67938c6b090249b17f48993aeb1d932", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/michaelhallquist/actions/runs/26851807627" }, { "r": "4.7.0", "os": "linux", "version": "0.9.2", "date": "2026-06-02T22:37:36.000Z", "distro": "noble", "arch": "x86_64", "commit": "64d7a09ac6caec9f4b33876d8e8e029e12982f88", "fileid": "8c8e48675eee98ae830a83234e96aafddcdab385d346cd594d0bca274a4eef52", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/michaelhallquist/actions/runs/26851807627" }, { "r": "4.6.0", "os": "linux", "version": "0.9.2", "date": "2026-06-02T22:37:20.000Z", "distro": "noble", "arch": "aarch64", "commit": "64d7a09ac6caec9f4b33876d8e8e029e12982f88", "fileid": "82c5d216d281763c5c1e45017fe96962a064d00659921acf82c75fc4578723f9", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/michaelhallquist/actions/runs/26851807627" }, { "r": "4.6.0", "os": "linux", "version": "0.9.2", "date": "2026-06-02T22:37:18.000Z", "distro": "noble", "arch": "x86_64", "commit": "64d7a09ac6caec9f4b33876d8e8e029e12982f88", "fileid": "77d5a12e313870f58282dc610d67e26059d061b9a55050ac8535ea525adad945", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/michaelhallquist/actions/runs/26851807627" }, { "r": "4.5.3", "os": "mac", "version": "0.9.2", "date": "2026-06-02T22:36:47.000Z", "arch": "aarch64", "commit": "64d7a09ac6caec9f4b33876d8e8e029e12982f88", "fileid": "3c7ec9edee00748422b1553eb45c22e883ef1ec58a858a55ceb113ccf5df881e", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/michaelhallquist/actions/runs/26851807627" }, { "r": "4.5.3", "os": "mac", "version": "0.9.2", "date": "2026-06-02T22:40:12.000Z", "arch": "x86_64", "commit": "64d7a09ac6caec9f4b33876d8e8e029e12982f88", "fileid": "001d895112cc880e45f654c2eddc117e8e105ab6337156739daf7a27e25d38e9", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/michaelhallquist/actions/runs/26851807627" }, { "r": "4.6.0", "os": "mac", "version": "0.9.2", "date": "2026-06-02T22:36:43.000Z", "arch": "aarch64", "commit": "64d7a09ac6caec9f4b33876d8e8e029e12982f88", "fileid": "068b4ccc84f00fd446fd98c8ca0541cf5fb1a4077678e78632c9b3b338280808", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/michaelhallquist/actions/runs/26851807627" }, { "r": "4.6.0", "os": "mac", "version": "0.9.2", "date": "2026-06-02T22:39:33.000Z", "arch": "x86_64", "commit": "64d7a09ac6caec9f4b33876d8e8e029e12982f88", "fileid": "d709a29074d042af8d459edf8456bf664ff8b6d2d94839ef005d5797dc1a5513", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/michaelhallquist/actions/runs/26851807627" }, { "r": "4.6.0", "os": "wasm", "version": "0.9.2", "date": "2026-06-02T22:37:11.000Z", "arch": "emscripten", "commit": "64d7a09ac6caec9f4b33876d8e8e029e12982f88", "fileid": "242b3aca2bed45922e32ed73e54a0ed0d59d573f601fefca7f8e5e19f6b4a479", "status": "success", "buildurl": "https://github.com/r-universe/michaelhallquist/actions/runs/26851807627" }, { "r": "4.7.0", "os": "win", "version": "0.9.2", "date": "2026-06-02T22:36:19.000Z", "arch": "x86_64", "commit": "64d7a09ac6caec9f4b33876d8e8e029e12982f88", "fileid": "e47c3a5a4eb0a5cc8cb15f481d88752a7acc86b0963fb5e258b25b2e5ebb616c", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/michaelhallquist/actions/runs/26851807627" }, { "r": "4.5.3", "os": "win", "version": "0.9.2", "date": "2026-06-02T22:35:58.000Z", "arch": "x86_64", "commit": "64d7a09ac6caec9f4b33876d8e8e029e12982f88", "fileid": "87b39b0112bec7feff770872ffe0d3339a9e2514c71f744b62dd181dade30a92", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/michaelhallquist/actions/runs/26851807627" }, { "r": "4.6.0", "os": "win", "version": "0.9.2", "date": "2026-06-02T22:36:13.000Z", "arch": "x86_64", "commit": "64d7a09ac6caec9f4b33876d8e8e029e12982f88", "fileid": "52704ee8c0433962a598036cb5d4dbfc540a8edd2baa44d30914a8c45bb557b2", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/michaelhallquist/actions/runs/26851807627" } ] }