[a]\n[b]\n[c]\n[d]\n...run graph combine then graph export in Stata and get:\n[abcd].png\n\n[1]\n[2]\n[3]\n[4]\n...graph combine and graph export to get:\n[1234].png<\/code><\/pre>\n\n\n\nBut what I want is one image that looks like this, stacking one on top of the other:<\/p>\n\n\n\n
[abcd\n 1234].png<\/code><\/pre>\n\n\n\nMy previous workflow was to open up GIMP<\/a> and manually combine them together. It turns out ImageMagick<\/a> allows you to do this from the command line, so you can embed a couple of lines of code in your Stata do file to combine images together quickly. You can read details on the append command here<\/a> (and also the related smush command here<\/a>). <\/p>\n\n\n\nGetting started with Imagemagick & Stata, and example on how to combine\/merge\/append images<\/h2>\n\n\n\n
Note: I am doing this on Windows. The process might be slightly different for Mac or *nix.<\/em><\/strong><\/p>\n\n\n\nAlso note: The examples here use PNG files since they are smaller than TIFF files. You might opt to use TIFF files since they are uncompressed and won’t introduce compression artifact with multiple manipulations. Journals will probably want TIFF files anyway so perhaps do that from the start.<\/em><\/strong><\/p>\n\n\n\nAlso also not<\/em><\/strong>e: Imagemagick doesn’t like extra spaces in code. If your code doesn’t run as expected, check that you don’t have extra spaces in your code.<\/strong> And also make sure you are also running the “local pwd=c(pwd)” command along with your other lines of code all at once.<\/strong><\/em> <\/p>\n\n\n\n\n- Step 1<\/strong>: Download and install ImageMagick<\/a>. Make sure to check the box next to “Add application directory to your system path”. This allows you to call ImageMagick from the command line so you can use it in Stata. <\/li>\n\n\n\n
- Step 2<\/strong>: From a do file, make some figures and use –graph export– to save them in your working directory as a common filetype (e.g., PNG, JPG, SVG). Let’s assume you have one figure called abcd.png and another called 1234.png.\n
\n- Note: Type -pwd- to see where your working directory is.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- Step 3<\/strong>: In your do file below the code that makes your two figures, call ImageMagick from the shell (“!” is the Stata command to call the shell), list out the names of the figures you want to combine, say you want to combine them, then tell it the name of the combined filetype.\n
\n- To simplify the code, we’ll also grab the present working directory and put it before the filename as a local macro. Since this uses local macros, you need to run all lines at once from a do file and not one-by-one in Stata. <\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
Combining figures using convert -append<\/h3>\n\n\n\n
Here’s some code that will vertically append a file “abcd.png” to “1234.png” and save as “abcd1234.png”: <\/p>\n\n\n\n
local pwd = c(pwd) \/\/ pluck stata's working directory\n\/\/\n!magick \/\/\/\nconvert \/\/\/\n\"`pwd'\/abcd.png\" \/\/\/\n\"`pwd'\/1234.png\" \/\/\/\n-append \/\/\/\n\"`pwd'\/abcd1234.png\"<\/code><\/pre>\n\n\n\nNote that if you want to combine them horizontally instead of vertically, you’d use “+append” instead.<\/p>\n\n\n\n
Combining figures using mosaic<\/h3>\n\n\n\n
Alternatively, you can use the mosaic <\/strong>command, and specify “concatenate” to do the same thing, specifying they are tiled in a 1×2 tiling (read about the mosaic command here<\/a>). Note that adding -label “” before each figure name keeps any generated labels from appearing under each figure in the final mosaic:<\/p>\n\n\n\nlocal pwd = c(pwd) \/\/ pluck stata's working directory\n\/\/\n!magick \/\/\/\nmontage \/\/\/\n-label \"\" \"`pwd'\/abcd.png\" \/\/\/\n-label \"\" \"`pwd'\/1234.png\" \/\/\/\n-mode Concatenate -tile 1x2 \/\/\/\n\"`pwd'\/abcd1234.png\"<\/code><\/pre>\n\n\n\nOr you can use the mosaic command to stick together all of the original figures as 4×2 tiling:<\/p>\n\n\n\n
local pwd = c(pwd) \/\/ pluck stata's working directory\n\/\/ \n!magick \/\/\/\nmontage \/\/\/\n-label \"\" \"`pwd'\/a.png\" \/\/\/\n-label \"\" \"`pwd'\/b.png\" \/\/\/\n-label \"\" \"`pwd'\/c.png\" \/\/\/\n-label \"\" \"`pwd'\/d.png\" \/\/\/\n-label \"\" \"`pwd'\/1.png\" \/\/\/\n-label \"\" \"`pwd'\/2.png\" \/\/\/\n-label \"\" \"`pwd'\/3.png\" \/\/\/\n-label \"\" \"`pwd'\/4.png\" \/\/\/\n-mode Concatenate -tile 4x2 \/\/\/\n\"`pwd'\/abcd1234.png\"<\/code><\/pre>\n\n\n\nAdding text\/annotation to your image<\/h2>\n\n\n\nAdding text label on the figure itself with Convert -annotate<\/h3>\n\n\n\n
You can also add some labels right on your figure with the “convert -annotate” command (details here<\/a>). Here we are adding a label “A)” and “B)” to the top left corner of each figure, or “Northwest” as defined by gravity (can use other cardinal directions too). You can move things up or down from the Northwest point if needed by changing the +0+0 (that’s +x+y) offset. <\/p>\n\n\n\nsysuse auto, clear\n\nset scheme s1mono \/\/ I like this scheme\ntwoway scatter mpg rep78\ngraph export 1234.png, width(1000) replace\n\ntwoway scatter rep78 mpg\ngraph export abcd.png, width(1000) replace \n\nlocal pwd = c(pwd) \/\/ pluck stata's working directory\n\/\/\n!magick \/\/\/\nconvert \/\/\/\n\"`pwd'\/abcd.png\" -gravity Northwest -pointsize 30 -annotate +10+0 \"A)\" \/\/\/\n\"`pwd'\/abcd_labeled.png\"\n\/\/\n!magick \/\/\/\nconvert \/\/\/\n\"`pwd'\/1234.png\" -gravity Northwest -pointsize 30 -annotate +10+0 \"B)\" \/\/\/\n\"`pwd'\/1234_labeled.png\"\n\/\/\n!magick \/\/\/\n\"`pwd'\/abcd_labeled.png\" \/\/\/\n\"`pwd'\/1234_labeled.png\" \/\/\/\n-append \/\/\/\n\"`pwd'\/abcd1234_labeled.png\"<\/code><\/pre>\n\n\n\nHere’s the resulting figure:<\/p>\n\n\n\n![\"\"](\"https:\/\/blog.uvm.edu\/tbplante\/files\/2022\/10\/image-2.png\")
<\/figure>\n\n\n\nAdding text above your figure with convert -label, then combining figures with mosaic<\/h3>\n\n\n\n
This will add a label above your image, instead of on <\/em>your image like convert -annotate. Here, the background is yellow so you can see it. Details are here<\/a>. <\/p>\n\n\n\n![\"\"](\"https:\/\/blog.uvm.edu\/tbplante\/files\/2022\/10\/abcd_labeled2.png\")
<\/figure>\n\n\n\nThis can be followed by a mosaic command so you can get a figure like this (with white label now). <\/p>\n\n\n\n![\"\"](\"https:\/\/blog.uvm.edu\/tbplante\/files\/2022\/10\/abcd1234_labeled_montage-2-656x1024.png\")
<\/figure>\n\n\n\nNote that Imagemagick will try to append the labels that you generated in prior lines (“A) Figure Name” and “B) Figure Name”) under each image before combining unless you specify -label “”. Code to make the above figures:<\/p>\n\n\n\n
sysuse auto, clear\n\nset scheme s1mono \/\/ I like this scheme\ntwoway scatter mpg rep78\ngraph export 1234.png, width(1000) replace\n\ntwoway scatter rep78 mpg\ngraph export abcd.png, width(1000) replace \n\nlocal pwd = c(pwd) \/\/ pluck stata's working directory\n\/\/ label\n!magick \/\/\/\nconvert \/\/\/\n\"`pwd'\/abcd.png\" -background white -pointsize 30 label:\"A) Figure Name\" +swap -gravity West -append \/\/\/\n\"`pwd'\/abcd_labeled.png\"\n\/\/\n!magick \/\/\/\nconvert \/\/\/\n\"`pwd'\/1234.png\" -background white -pointsize 30 label:\"B) Figure Name\" +swap -gravity West -append \/\/\/\n\"`pwd'\/1234_labeled.png\"\n\/\/ combine as a montage\n!magick \/\/\/\nmontage \/\/\/\n-label \"\" \"`pwd'\/abcd_labeled.png\" \/\/\/\n-label \"\" \"`pwd'\/1234_labeled.png\" \/\/\/\n-mode Concatenate -tile 1x2 \/\/\/\n\"`pwd'\/abcd1234_labeled_montage.png\"<\/code><\/pre>\n\n\n\nGenerating an image with text then sticking that on top of your figures<\/h3>\n\n\n\n
ImageMagick will allow you to make an image that’s just text, which you can then stack on top of your figures using the montage feature. Just make sure to set the text width to be the same width as your figure, 1000 pixels here. You will stack them like this:<\/p>\n\n\n\n
[abcd_label <-newly generated image of just text\nabcd\n1234_label <-newly generated image of just text\n1234]<\/code><\/pre>\n\n\n\nAnd you’ll get something like this:<\/p>\n\n\n\n![\"\"](\"https:\/\/blog.uvm.edu\/tbplante\/files\/2022\/10\/abcd1234_labeled_montage-3-641x1024.png\")
<\/figure>\n\n\n\nsysuse auto, clear\n\nset scheme s1mono \/\/ I like this scheme\ntwoway scatter rep78 mpg\ngraph export abcd.png, width(1000) replace \n\ntwoway scatter mpg rep78\ngraph export 1234.png, width(1000) replace\n\nlocal pwd = c(pwd) \/\/ pluck stata's working directory\n\/\/ make two separate text labels that you will later combine with your\n\/\/ abcd and 1234 figures using montage\n\/\/ \n\/\/ first make the labels\n\/\/ note: the caption option will use word wrap if it's too wide. \n\/\/ This is 1000 pixels wide to match the other figures. \n\/\/\n!magick \/\/\/\nconvert \/\/\/\n-background none -size 1000x -fill black -font ariel -pointsize 30 caption:\"A) Figure Name\" \/\/\/\n\"`pwd'\/abcdlabel.png\"\n\/\/\n!magick \/\/\/\nconvert \/\/\/\n-background none -size 1000x -fill black -font ariel -pointsize 30 caption:\"B) Figure Name\" \/\/\/\n\"`pwd'\/1234label.png\"\n\/\/now use montage to put those labels on top of your other ones. \n\/\/combine as a montage\n\/\/\n!magick \/\/\/\nmontage \/\/\/\n-label \"\" \"`pwd'\/abcdlabel.png\" \/\/\/\n-label \"\" \"`pwd'\/abcd.png\" \/\/\/\n-label \"\" \"`pwd'\/1234label.png\" \/\/\/\n-label \"\" \"`pwd'\/1234.png\" \/\/\/\n-mode Concatenate -tile 1x4 \/\/\/\n\"`pwd'\/abcd1234_labeled_montage.png\"<\/code><\/pre>\n\n\n\nOther useful functions of Imagemagick<\/h2>\n\n\n\nConvert and -Trim<\/h3>\n\n\n\n
Trimming removes all of the extra border around your figure. The border is defined as whatever color the pixel in the corner is. So if you have a figure that looks like this:<\/p>\n\n\n\n![\"\"](\"https:\/\/blog.uvm.edu\/tbplante\/files\/2022\/10\/abcd.png\")
<\/figure>\n\n\n\nTrimming will remove the small amount of blue space outside of your labels and around the figure, so you get this:<\/p>\n\n\n\n![\"\"](\"https:\/\/blog.uvm.edu\/tbplante\/files\/2022\/10\/abcd_trim.png\")
<\/figure>\n\n\n\nCode to do this:<\/p>\n\n\n\n
sysuse auto, clear\nset scheme s2color \/\/ stata's default scheme\ntwoway scatter rep78 mpg\ngraph export abcd.png, width(1000) replace \n\/\/\nlocal pwd = c(pwd) \/\/ pluck stata's working directory\n\/\/\n!magick \/\/\/\nconvert \/\/\/\n\"`pwd'\/abcd.png\" -trim \/\/\/\n\"`pwd'\/abcd_trim.png\"<\/code><\/pre>\n\n\n\nReplicating Stata’s Graph Combine feature<\/h3>\n\n\n\n
I’m not quite sure why you’d want to do this, but you can combine several figures without axis labels and use one overall label like specifying l1label <\/em>and b1label <\/em>in –graph combine–. This code makes 4 separate figures without labels then merges them together then generates text to go on the left side vertically and on the bottom horizontally. You get this figure in the end:<\/p>\n\n\n\n![\"\"](\"https:\/\/blog.uvm.edu\/tbplante\/files\/2022\/10\/1234_labeled-1024x203.png\")
<\/figure>\n\n\n\nsysuse auto, clear\nset scheme s1mono \/\/ I like this scheme\n\/\/\n\/\/ Make 4 figures without labels\ntwoway scatter mpg weight if rep78==1 \/\/\/\n, \/\/\/\nxti(\"\") \/\/\/\nyti(\"\")\n\/\/\ngraph export 1.png, width(1000) replace\n\/\/\ntwoway scatter mpg weight if rep78==2 \/\/\/\n, \/\/\/\nxti(\"\") \/\/\/\nyti(\"\")\n\/\/\ngraph export 2.png, width(1000) replace\n\/\/\ntwoway scatter mpg weight if rep78==3 \/\/\/\n, \/\/\/\nxti(\"\") \/\/\/\nyti(\"\")\n\/\/\ngraph export 3.png, width(1000) replace\n\/\/\ntwoway scatter mpg weight if rep78==4 \/\/\/\n, \/\/\/\nxti(\"\") \/\/\/\nyti(\"\")\n\/\/\ngraph export 4.png, width(1000) replace\n\/\/ \nlocal pwd = c(pwd) \/\/ pluck stata's working directory\n\/\/ now merge the 4 figures horizontally:\n!magick \/\/\/\nmontage \/\/\/\n-label \"\" \"`pwd'\/1.png\" \/\/\/\n-label \"\" \"`pwd'\/2.png\" \/\/\/\n-label \"\" \"`pwd'\/3.png\" \/\/\/\n-label \"\" \"`pwd'\/4.png\" \/\/\/\n-mode Concatenate -tile 4x1 \/\/\/\n\"`pwd'\/1234_noaxislabel.png\"\n\/\/ now make a side label as a text block:\n\/\/\n!magick \/\/\/\nconvert \/\/\/\n-pointsize 50 label:\"Side Label!\" -rotate -90 \/\/\/\n\"`pwd'\/1234sidelabel.png\"\n\/\/\n\/\/ ditto bottom label: \n\/\/\n!magick \/\/\/\nconvert \/\/\/\n-pointsize 50 label:\"Bottom Label!\" -rotate -0 \/\/\/\n\"`pwd'\/1234bottomlabel.png\"\n\/\/\n\/\/ now combine them together:\n!magick convert \\( \"`pwd'\/1234sidelabel.png\" \"`pwd'\/1234_noaxislabel.png\" -gravity Center +append \\) \\( \"`pwd'\/1234bottomlabel.png\" \\) -append 1234_labeled.png<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"Sometimes you want to combine two figures in Stata but the –graph combine– command isn’t doing it for you for whatever reason. I’ve run into this when I’ve already merged several figures (abcd), and want to combine that with another merged figure (1234): But what I want is one image that looks like this, stacking … Continue reading Appending\/merging\/combining Stata figures\/images with ImageMagick<\/span><\/a><\/p>\n","protected":false},"author":4473,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[703423,703422,703425,703409,247,703426,102693,502556],"class_list":["post-1238","post","type-post","status-publish","format-standard","hentry","category-uncategorized","tag-appending","tag-combining","tag-figure","tag-graph-combine","tag-image","tag-imagemagick","tag-merging","tag-stata"],"_links":{"self":[{"href":"https:\/\/blog.uvm.edu\/tbplante\/wp-json\/wp\/v2\/posts\/1238","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.uvm.edu\/tbplante\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.uvm.edu\/tbplante\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.uvm.edu\/tbplante\/wp-json\/wp\/v2\/users\/4473"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.uvm.edu\/tbplante\/wp-json\/wp\/v2\/comments?post=1238"}],"version-history":[{"count":20,"href":"https:\/\/blog.uvm.edu\/tbplante\/wp-json\/wp\/v2\/posts\/1238\/revisions"}],"predecessor-version":[{"id":1364,"href":"https:\/\/blog.uvm.edu\/tbplante\/wp-json\/wp\/v2\/posts\/1238\/revisions\/1364"}],"wp:attachment":[{"href":"https:\/\/blog.uvm.edu\/tbplante\/wp-json\/wp\/v2\/media?parent=1238"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.uvm.edu\/tbplante\/wp-json\/wp\/v2\/categories?post=1238"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.uvm.edu\/tbplante\/wp-json\/wp\/v2\/tags?post=1238"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}