{"id":13400616,"url":"https://github.com/VPetukhov/ggrastr","last_synced_at":"2025-03-14T06:31:47.127Z","repository":{"id":43343310,"uuid":"111200990","full_name":"VPetukhov/ggrastr","owner":"VPetukhov","description":"Raster geoms for ggplot2","archived":false,"fork":false,"pushed_at":"2023-06-06T22:42:13.000Z","size":25499,"stargazers_count":212,"open_issues_count":0,"forks_count":18,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-09-25T22:54:03.949Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VPetukhov.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-11-18T11:44:07.000Z","updated_at":"2024-07-17T18:59:18.000Z","dependencies_parsed_at":"2022-07-11T23:00:31.601Z","dependency_job_id":"ee50686a-f373-478b-b53b-e2e592f4b12c","html_url":"https://github.com/VPetukhov/ggrastr","commit_stats":{"total_commits":188,"total_committers":8,"mean_commits":23.5,"dds":0.2872340425531915,"last_synced_commit":"7aed9af2b9cffabda86e6d2af2fa10d4e60cc63d"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VPetukhov%2Fggrastr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VPetukhov%2Fggrastr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VPetukhov%2Fggrastr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VPetukhov%2Fggrastr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VPetukhov","download_url":"https://codeload.github.com/VPetukhov/ggrastr/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243537778,"owners_count":20307098,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-30T19:00:53.951Z","updated_at":"2025-03-14T06:31:47.119Z","avatar_url":"https://github.com/VPetukhov.png","language":"R","funding_links":[],"categories":["Plot layers","R"],"sub_categories":[],"readme":"[![\u003cVPetukhov\u003e](https://circleci.com/gh/VPetukhov/ggrastr.svg?style=svg)](https://app.circleci.com/pipelines/github/VPetukhov/ggrastr)\n[![CRAN status](https://www.r-pkg.org/badges/version/ggrastr)](https://cran.r-project.org/package=ggrastr)\n[![CRAN downloads](https://cranlogs.r-pkg.org/badges/ggrastr)](https://cran.r-project.org/package=ggrastr)\n\n# ggrastr\n\nRasterize only specific layers of a [ggplot2 plot](https://ggplot2.tidyverse.org/) (for instance, large scatter plots with many points) while keeping all labels and text in vector format. This allows users to keep plots within a reasonable size limit without losing the vector properties of scale-sensitive information. \n\n## Installation\n\nTo install the stable version from [CRAN](https://CRAN.R-project.org/package=ggrastr), use:\n\n```r\ninstall.packages('ggrastr')\n```\n\nTo install the latest version, use:\n\n```r\ninstall.packages('devtools')\ndevtools::install_github('VPetukhov/ggrastr', build_vignettes = TRUE)\n```\n\n## Rasterize any ggplot2 layer\n\nNote that with `ggrastr` version 0.2.0, any ggplot2 geom provided by the user can be rasterized with the function `rasterise()`. Furthermore, when the aspect ratio is distorted, points are rendered without distortion. \n\nFor more details and examples, see the **vignettes:**\n* [HTML version](https://htmlpreview.github.io/?https://raw.githubusercontent.com/VPetukhov/ggrastr/main/doc/Raster_geoms.html) \n* [Markdown version](https://github.com/VPetukhov/ggrastr/blob/main/vignettes/Raster_geoms.md)\n\n## Geoms provided\n\nWe also provide wrappers for several geoms to guarantee compatibility with an older version of `ggrastr`. However, we encourage users to use the `rasterise()` function instead.\n\n* `geom_point_rast`: raster scatter plots\n* `geom_jitter_rast`: raster jittered scatter plots\n* `geom_boxplot_jitter`: boxplots that allows to jitter and rasterize outlier points\n* `geom_tile_rast`: raster heatmap\n* `geom_beeswarm_rast`: raster [bee swarm plots](https://github.com/eclarke/ggbeeswarm#geom_beeswarm)\n* `geom_quasirandom_rast`: raster [quasirandom scatter plot](https://github.com/eclarke/ggbeeswarm#geom_quasirandom)\n\n\n## Troubleshooting\n\nIf your R session crashes when you try to render a rasterized plot, it's probably the case that your version of Cairo was built for another \nversion of R (see [Upgrading to a new version of R](https://shiny.rstudio.com/articles/upgrade-R.html)). To check if \nyou are using a proper version, run the command below and ensure that the \"Built\" version is the same as your R version.\n```r\npkgs \u003c- as.data.frame(installed.packages(), stringsAsFactors = FALSE, row.names = FALSE)\npkgs[pkgs$Package == 'Cairo', c(\"Package\", \"LibPath\", \"Version\", \"Built\")]\n```\n\nTo ensure that Cairo works, try running `Cairo::Cairo(type='raster'); dev.off()` and check if it crashes your R session.\n\n## Citation\n\nIf you find `ggrastr` useful for your publication, please cite:\n\n```\nViktor Petukhov, Teun van den Brand and Evan Biederstedt (2021).\nggrastr: Raster Layers for 'ggplot2'. R package version 1.0.2.\nhttps://CRAN.R-project.org/package=ggrastr\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FVPetukhov%2Fggrastr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FVPetukhov%2Fggrastr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FVPetukhov%2Fggrastr/lists"}