# ggplotify 0.1.3

+ `as.grob` for `tmap` object, defined in the 'tmap' package (2025-09-20, Sat) 
+ replace `aes_` with `aes` (2025-09-20, Sat)

# ggplotify 0.1.2

+ support `oncoplot` object in 'aplot' and 'aplotExtra' (2023-07-18, Tue)

# ggplotify 0.1.1

+ supports `gglist` object (2023-06-26, Mon)

# ggplotify 0.1.0

+ supports `bbplot` object (2021-09-02, Thu)

# ggplotify 0.0.9

+ import `yulab.utils` (2021-08-20, Fri)
+ `...` parameter in `as.ggplot` (2021-08-06, Fri)

# ggplotify 0.0.8

+ allows passing `envir` to `base2grob` (2021-08-04, Wed, #11)

# ggplotify 0.0.7

+ `patchwork` object supported (2021-05-11, Tue)

# ggplotify 0.0.6

+ `aplot` object supported (2020-03-27, Fri)
  - <https://github.com/YuLab-SMU/aplot>
+ angle parameter in `as.ggplot` (2020-03-16, Mon)

# ggplotify 0.0.5

+ `hjust` and `vjust` parameters in `as.ggplot` (2020-03-11, Wed)
+ `grid2grob` for all plot generated by `grid` (2019-08-21, Wed)
  - can be converted also using expression or function that supported in previous version

# ggplotify 0.0.4

+ `as.grob` method for `Heatmap` object (defined in ComplexHeatmap package) (2019-08-06, Tue)
+ `as.grob` method for `eulergram` object (defined in eulerr package) (2019-05-09, Thu)
  - <https://github.com/GuangchuangYu/ggplotify/issues/5>

# ggplotify 0.0.3

+ `as.grob` method for `pheatmap` object (2018-08-03, Fri)
    - thanks to my PR: <https://github.com/raivokolde/pheatmap/pull/43>
+ support converting `magick-image` to `grob` and `ggplot` object.  (2018-04-25, Wed)
+ redefined `as.grob` as S3 Generics.

# ggplotify 0.0.2

+ add NEWS.md, README and example in man (2018-04-24, Tue)

# ggplotify 0.0.1

+ `as.grob` by combining `ggimage::toGrob` and `base2grob` package which was deprecated
  - `as.grob` can convert base plot or grid plot (e.g. vcd, UpSetR packages) to
    `grob` object
+ `as.ggplot` supports all `as.grob`-supported plots.


# History of ggplot 0.0.0 

## embed base to grid plot (2015, ChIPseeker)

I figured out a way to embed base plot (`vennpie`) to grid plot (`upset`) when
developing `upsetplot` function in `ChIPseeker` package for visualizing overlap
of ChIPseq data in 2015, <http://guangchuangyu.github.io/2015/07/upsetplot-in-chipseeker/>.

## embed ggplot (2015, ggtree and ggimage)

I developed a `subview` function in `ggtree` package in 2015, for embeding
subplots,
<https://github.com/YuLab-SMU/ggtree/commit/2ab2876d5e92454869c3307ea6f3c8e2656630ef>.

This function was re-implemented as `geom_subview` and packed in the `ggimage`
package.

## embed plots (base, lattic, ggplot or image) to ggplot (2017, ggimage and hexSticker)

In the early of 2017, I started to develop R script to produce `ggtree` sticker.
[@lgatto](https://github.com/lgatto) first came out with an idea of makeing an R package for producing hex
sticker by packing my script into a function, <https://github.com/Bioconductor/BiocStickers/issues/12>. I have
several ideas to improve the package, including producing print-ready figure,
employing modular design and supporting grammar of graphics, as well as supporting
subplot generated by base and lattice. I started to develop the
`hexSticker` package, <https://github.com/GuangchuangYu/hexSticker/issues/2>,
with base plot, lattice, ggplot2 and image file supported as subplot, which was
actually implemented in `ggimage` (`toGrob` function, image file are supported
by `geom_image`).


## convert base to grob (2018, base2grob)

I wrote a blog
post, <http://guangchuangyu.github.io/cn/2018/03/five-questions-of-meme/>, to
ask questions based on the `meme` package to help users understand `ggplot2`.

After I wrote the sentence:

> if you know how `ggsave` works, you can even extend it to support base plot

I started to extend `ggsave` to support base plot by using formula or
expression, *e.g.* `ggsave(~base_plot)`.

After that, I asked myself, why not extending `cowplot` to support base plot
with the fact that I already have source code to convert base plot to `grob`
object (`ggimage:::toGrob`). Then I developed the `base2grob` package and submit
it to CRAN.

## convert (almost all) plots to ggplot (2018, ggplotify)

I wrote a blog post, http://guangchuangyu.github.io/cn/2018/04/ggvenn/, to
introduce `ggvenn` function (in `yyplot` package, only available on GitHub), and started
to play with the `UpSetR` package. I believe `upset` plot contains too much
empty space and can embed a `venn` plot as I did in 2015 with `vennpie`. I created a
PR, <https://github.com/hms-dbmi/UpSetR/pull/112>, to make it possible to
capture `upset` output and be able to be converted to `grob` object. I thought it would be more
easy if I further convert the object to `ggplot` then I can directly use
`ggimage::geom_subview()` to embed `ggvenn` inside `upset` plot. With this idea,
I started to implement `as.ggplot` function.

Then, I suddenly realized that I should packed `as.ggplot`, `ggimage:::toGrob` and
`base2grob` into a single package. That's why we have `ggplotify`, which
contains `as.grob` to convert plots to `grob` and `as.ggplot` to convert plots
to `ggplot` objects.

