**Author**: Benoit Aigouy
Link to a video demo: [https://youtu.be/YZsSWBxcdDM>](https://youtu.be/YZsSWBxcdDM) </span </div> ## **Table of Contents** [1) Install EZFig](#RefHeadingToc27213566485089) [1.1) Install as a Fiji plugin](#RefHeadingToc27233566485089) [2) User Interface](#RefHeadingToc27273566485089) [2.1) Quick overview of the EZFig user interface](#RefHeadingToc28843566485089) [2.2) Quick description](#RefHeadingToc28863566485089) [2.3) Magnification buttons](#RefHeadingToc27293566485089) [3) Imports](#RefHeadingToc27413566485089) [3.1) Importing files : Drag and drop](#RefHeadingToc27433566485089) [3.2) Importing files via the EZFig menu](#RefHeadingToc27453566485089) [3.3) Importing files from ImageJ/Fiji](#RefHeadingToc27473566485089) [4) Load/Save EZFig files](#RefHeadingToc27493566485089) [4.1) Load .ezf Files](#RefHeading30901992981752) [4.2) Save .ezf files](#RefHeading30921992981752) [5) Exports](#RefHeadingToc27513566485089) [5.1) Direct exports](#RefHeadingToc27533566485089) [5.2) Export to ImageJ](#RefHeadingToc27553566485089) [6) Selections](#RefHeadingToc27573566485089) [6.1) The basics of object selection in EZFig](#RefHeadingToc27593566485089) [7) Menus](#RefHeadingToc27613566485089) [7.1) File](#RefHeadingToc27633566485089) [7.2) Edit](#RefHeadingToc27653566485089) [7.3) Journals](#RefHeadingToc27673566485089) [7.4) Keep For Later](#RefHeadingToc27693566485089) [7.5) Checks](#RefHeadingToc27713566485089) [7.6) FiguR](#RefHeadingToc27733566485089) [7.7) Help](#RefHeadingToc27753566485089) [8) Dynamic menus ](#RefHeadingToc27773566485089) [8.1) "Figure" objects parameters](#RefHeadingToc27793566485089) [8.1.1) "Size" tab](#RefHeadingToc27813566485089) [8.1.2) "Labels" tab](#RefHeadingToc27833566485089) [8.1.3) "Layout" tab (only available in free mode)](#RefHeadingToc27853566485089) [8.1.4) "Misc" tab](#RefHeadingToc27873566485089) [8.2) "Row" objects parameters](#RefHeadingToc27893566485089) [8.2.1) "Size" tab](#RefHeadingToc27913566485089) [8.2.2) "Labels" tab](#RefHeadingToc27933566485089) [8.3) "Panel/Montage" objects parameters](#RefHeadingToc27953566485089) [8.3.1) "Layout" tab](#RefHeadingToc27973566485089) [8.3.2) "AutoCrops" tab](#RefHeadingToc27993566485089) [8.4) "Image/ImagePlus/Stack/Graph/Vector Image" objects parameters](#RefHeadingToc28013566485089) [8.4.1) "Labels" tab](#RefHeadingToc28033566485089) [8.4.2) "Crop" tab](#RefHeadingToc28053566485089) [8.4.3) "Orientation/Rotation" tab](#RefHeadingToc28073566485089) [8.4.4) "Stack/Video" tab](#RefHeadingToc28093566485089) [8.4.5) "Misc" tab](#RefHeadingToc28113566485089) [9) Figure layout](#RefHeadingToc28133566485089) [9.1) Change figure size](#RefHeadingToc28153566485089) [9.2) Change layout](#RefHeadingToc28173566485089) [10) Annotating Images](#RefHeadingToc28193566485089) [10.1) Add letters, labels and scalebar to an image](#RefHeadingToc28213566485089) [10.2) Add ROIs/Floating text labels to an image](#RefHeadingToc28233566485089) [10.3) Convert ROIs to crop or insets (Picture In Picture, PIP)](#RefHeadingToc28253566485089) [10.4) Add labels outside images/rows](#RefHeading3128459311110) [11) Keep for later](#RefHeadingToc28273566485089) [12) Manipulate image channels](#RefHeadingToc28293566485089) [12.1) Select or create an image with channels](#RefHeadingToc28313566485089) [12.2) Activate/inactivate channels](#RefHeadingToc28333566485089) [12.3) Change channel colour](#RefHeadingToc28353566485089) [13) Use drag and drop to build a figure efficiently](#RefHeadingToc28373566485089) [13.1) Add inset using drag and drop](#RefHeadingToc28393566485089) [13.2) Add an image to a row](#RefHeadingToc28413566485089) [13.3) Create a new row from an image/remove an image from a row](#RefHeadingToc28433566485089) [13.4) Create a panel, add it to a row and change its layout](#RefHeadingToc28453566485089) [13.5) List of DND options and their use](#RefHeadingToc28473566485089) [14) Add inset/Picture in picture (PIP) from the local drive](#RefHeadingToc28493566485089) [15) Journal styles](#RefHeadingToc28513566485089) [15.1) Select a journal style](#RefHeadingToc28533566485089) [15.2) Create a new journal style](#RefHeadingToc28553566485089) [16) Editorial Checks](#RefHeadingToc28573566485089) [16.1) Check Size](#RefHeadingToc28593566485089) [16.2) Check style](#RefHeadingToc28613566485089) [16.3) Check Fonts](#RefHeadingToc28633566485089) [16.4) Check line arts](#RefHeadingToc28653566485089) [16.5) Check Text](#RefHeadingToc28673566485089) [16.6) Check Graphs](#RefHeadingToc28693566485089) [17) FiguR](#RefHeadingToc28713566485089) [17.1) Install and configure R (required for FiguR to work)](#RefHeadingToc28733566485089) [17.2) Launch FiguR](#RefHeadingToc28753566485089) [18) Settings](#RefHeadingToc28773566485089) [18.1) Undos/Redos](#RefHeadingToc28793566485089) [18.2) Shortcuts](#RefHeadingToc28813566485089) # 1) Install EZFig ## 1.1) Install as a Fiji plugin Download and install the latest Fiji available for your OS (from [https://fiji.sc/](https://fiji.sc/)). Launch Fiji. !(/media/images37.png) Press Help › Update... !(/media/images38.png) Press "Manage update sites" !(/media/image86.png) !(/media/image87.png) locate EZFig and select it. Alternatively press "Add update site" (or just "Add" depending on the version of Fiji). Then type in the blank URL field : [http://sites.imagej.net/EZF/](http://sites.imagej.net/EZF/) !(/media/image88.png) Fiji offers to install EZFig. Press "Apply Changes". !(/media/images42.png) Press "Ok" and close Fiji (this is very important) !(/media/image36.png) Restart Fiji, press Plugin › EZFig › EZFig to launch the software # 2) User Interface ## 2.1) Quick overview of the EZFig user interface !(/media/image43.png) ## 2.2) Quick description **Journal style** : Select the journal style there. Journal styles help users endorse journal guidelines (See sections "Journal styles" and "Editorial checks"). **Tips** : displays various EZFig tips. **R connection** : if the icon is red R is not connected, green otherwise (see section "FiguR"). **Display magnification settings** : see section "Magnification buttons". **Menu bar** : Please see the "Menus" section **Free mode** : if you press this the "figure" objects will be manually positioned by the user. The layout of the "figure" content is handled by EZFig. If you do not activate this mode all the layout is handled by EZFig. Nb : please note that the content of the "available actions" panel depends on current selection type (see the "Dynamic menus" section). !(/media/image49.png) **Logger :** Finally, EZFig also comes with a logger (arrow), that logs all messages sent by EZFig and FiguR (black) as well as software errors (red). ## 2.3) Magnification buttons **zoom in** !(/media/images30.png) press this button to zoom in. **zoom out** !(/media/images31.png) press this button to zoom out. **best fit** !(/media/images32.png) press this button to fit the figure in width and in height to the field of view. **best fit width or height** !(/media/images33.png) press this button to fit the figure in width to the field of view. !(/media/images35.png) !(/media/images34.png) press again the same button to fit height. Note that the green rectangle indicates page size for the selected journal. **reset zoom** !(/media/images36.png) press this button to restore default magnification # 3) Imports The easiest way to import files in EZFig is to use drag n drop. ## 3.1) Importing files : Drag and drop !(/media/images1.png) To load image(s) with EZFig, you can select images in a folder then drag and drop them anywhere onto the EZFig user interface. !(/media/images2.png) Dropped images are added as a single row by default (organisation can be changed later on). ## 3.2) Importing files via the EZFig menu !(/media/images4.png) Press File › Import images !(/media/images3.png) A dialog opens to select files. Supported formats are : jpg, tif, png, bmp, tga, lsm, svg, figur, gif. ## 3.3) Importing files from ImageJ/Fiji !(/media/images6.png) Open an image or a stack in ImageJ (here I opened the ImageJ sample image 'blobs.gif') !(/media/images5.png) Select "import single image from ImageJ" if you want to import the currently displayed image. Alternatively select "import stack from ImageJ", if you want to be able to activate/deactivate channels, change channel color, or browse slices or frames of the image. !(/media/images7.png) The image has been successfully imported in EZFig. # 4) Load/Save EZFig files EZFig has its own native format (.ezf). It is very important to always save the figure in "ezf" format as it is the only format that can be re-edited by EZFig, all other export formats cannot be dynamically modified. EZFig is backward compatible width ScientiFig, i.e. it can read ScientiFig files (.yf5m). The opposite is not true, ScientiFig cannot read .ezf files. ## 4.1) Load .ezf Files The simplest way to load an ezf or a yf5m file is to drag and drop it onto EZFig. !(/media/images60.png) Alternatively, press File › Open ## 4.2) Save .ezf files !(/media/images61.png) Press File › Save as... to save an "ezf" file. Note that if the figure contains stacks, they will be saved in a folder with the same name as the "ezf" file with an extra .files. Please always store the .ezf and the .ezf.files folder together, otherwise stack data will be lost. Nb: You can use the ⌃ Ctrl / ⌘ ⌃ Ctrl on a PC ⌘ command on a Mac + S shortcut to save. # 5) Exports ## 5.1) Direct exports !(/media/image34.png) To export a Figure, press File › Export as... and select one of the export formats available. Please note that exported files cannot be further edited by EZFig, so it is particularly important to also "save" your figures (see Section "Save .ezf files"). EZFig can export figures as raster/bitmap images :
-as **PNG** images (lossless compression) with background transparency (good for office presentations)
-as flattened **TIF** images (lossless compression, good for scientific publication)
-as **JPG** (lossy compression, good for talks but not for publication)EZFig can export figures as vector images :
\-**SVG** can be further edited even text by your favourite vector graphics editor (e.g. Illustrator, Inkscape, ...). I highly recommend this format for vector export.
\-**EPS** (encapsulated postscript)
\-**PS** (postscript)EZFig can export figures as videos (this only makes sense if the Figure contains Stack or videos) :
\-**AVI** (you can set the frame per seconds and resolution).Also Figures can also be **exported to ImageJ**. See below. ## 5.2) Export to ImageJ !(/media/image1.png) Press File › Export to ImageJ !(/media/image2.png) The image is opened in ImageJ as an ImagePlus Nb : the figure can also be exported as an ImageJ stack (provided the figure itself contains stacks). To do so press File › Export to ImageJ Stack # 6) Selections EZFig is an object based (vectorial) software. Below are the various EZFig objects you can manipulate as well as informations about their selection. ## 6.1) The basics of object selection in EZFig
Selection can be reset anytime by clicking outside of the figure/images!(/media/images56.png) Clicking the upper right image selects the whole "Figure", the highest level container in EZFig (note the yellow color of the selection and the "Figure" keyword drawn in the center of the figure object) !(/media/images57.png) Clicking the upper right image again selects a "Row", a lower level container in EZFig. (Note the cyan color of the selection and the "Row" keyword drawn in the center of the "row" object). !(/media/images58.png) Clicking the upper right image again selects a "Panel/Montage", yet another lower level container. (Note the magenta color of the selection and the "Panel" keyword drawn in the center of the Panel object). !(/media/images59.png) Clicking the upper right image again finally selects the image, the lowest level object in the figure hierachy. (Note the red color of the selection and the "Img" keyword drawn in the center of the "image" object). **Note that the options in the panel located at the right of the software change with selection type. Options will also change depending on whether it is a single selection or multiple selection. Multiple selection is obtained by maintaining the ⌃ Ctrl / ⌘ ⌃ Ctrl on a PC ⌘ command on a Mac key while clicking.** Summary of the hierarchy of objects in EZFig and their associated colour selection scheme :
hierarchy : "Figure > Row > Panel/Montage > Image"
Color when selected :Orange > Cyan > Magenta > Red# 7) Menus ## 7.1) File Please find below a complete description of the "File" menu : !(/media/image37.png) **New **: Creates a new empty figure. **Open **: prompts a dialog to load .ezf (EZFig) and .yf5m (ScientiFig) files. You can also simply use drag and drop (DND). **Import images** : prompts a dialog to import raster/bitmap or vector images to EZFig. You can also use DND (please also see the "Imports" section). **Import single image from ImageJ** : First open an image in ImageJ, select the channels you want to display, the contrast settings, the slice and or frame you want to insert in a figure. Then press this button to import the current display to EZFig. (Nb : reference to the original file is not stored in EZFig so you will not be able to further change its settings, such as contrast or Z Slice, t frame or anything else...). **Import stack from ImageJ** : First open a stack or a video in ImageJ (it can be a virtual stack). Then press this button and a copy of the ImagePlus will be stored in your figure. EZFig will still be able to edit image channels, channel colours, select Z slice or t frames. **Save** : Saves an "ezf" file, the native file format for EZFig. Please always save your figures in this format as this is the only file format EZFig can reedit and modify. **Save As** : Same as "save" but prompts for the output file name. **Exports As** : exports the current figure to several file formats (please also see the "Exports" section). **Export to ImageJ **: export the current Figure to ImageJ as an ImagePlus. **Export to ImageJ stack **: export the current Figure to ImageJ as an ImagePlus containing an ImageStack. **Extract Images from current figure** : export images embedded in the current figure to a folder. **Quit**: quits/closes EZFig. ## 7.2) Edit Please find below a complete description of the "edit" menu : !(/media/image38.png) **Software Preferences** : Set EZFig default preferences. Undos/Redos can be activated there. **Delete Selection** : Deletes the current selection from the figure (Note that you can also use the keyboard Del/Suppr key to achieve the same result) **Capitalize first letter** : force the first letter of text fields of the figure to be upper or lower case. **Select and apply a font or text color or background color to all components** : Can be used to set font, text foreground and background colours for all the text fields associated to the figure images. **Select and apply a specific line width/point size to graphs/ROIs/embedded SVG images** : set line arts point line width for graphs, svg images and user drawn ROIs. **Apply the selected journal style to all components** : Applies the current journal style to all images in the figure. **Remove all text** : removes all text fields from the current figure (can be used to clean figure for talks). **Remove all scale bars **: removes all scale bars (can be used to clean figure for talks). **Remove all ROIs** : removes all ROIs and floating text from the current figure (can be used to clean figure for talks). ## 7.3) Journals Please find below a complete description of the "Journals" menu : !(/media/image39.png) **Create new journal/plot style** : Creates a new journal style (please also see the "Journal styles" section). **Edit current journal/plot style** : Edit the settings of the selected journal style. **Permanently Delete journal/plot style** : Delete a journal style (in fact the file is just renamed as .old, so if you change your mind you can still recover it manually). ## 7.4) Keep For Later Please find below a complete description of the "Keep For Later" menu and its functions : !(/media/image44.png) **Keep current selection for later** : Use this if you don't want the selection to appear in the current figure, but nevertheless want to keep it, for example because you plan to use it later. The content of the "Keep For Later" menu is stored in the .ezf file. "kept for later" selected objects appear in this menu as new buttons together with an icon (see **Custom content** below) and the menu turns red. **Permanently delete all elements stored below (please pay attention, it's irreversible)** : Removes all elements from the "Keep For Later" menu (pressing this button erases the content of this menu and therefore these images are no longer saved in the .ezf file), so be careful with this. **Add all elements stored below back to the original figure** : Adds back to the figure, the content of the "Keep For Later" menu. **Custom content** : The "Keep For Later" menu may contain custom content added by the user. This content is made available as a button, pressing a button adds its content back to the figure. ## 7.5) Checks Please see the "Editorial Checks" section. !(/media/image40.png) ## 7.6) FiguR Please see the "FiguR" section. !(/media/image41.png) ## 7.7) Help Please find below a complete description of the "/help" menu : !(/media/image42.png) **Show/Hide tips** : Hides the EZFig tips widow (if visible), shows it otherwise. **Help content** : Shows this help file. **Show R installation guidelines** : Shows how to install and configure R to use it with FiguR (see also the "FiguR" section). **Shortcuts** : Shows EZFig shortcuts. Custom shortcuts can be defined there. Shortcuts can also be reset (see also the "Settings" section). **About/licenses** : Shows the licence file for EZFig and its associated libraries. If you disagree with these licences please delete EZFig from your computer. !(/media/image48.png) **Citations** : Shows some citations you can use in your manuscripts/talks if you really like EZFig. **Load random demo images** : Random images (just for me to do some debugging). # 8) Dynamic menus The content of the right side of the EZFig will change dynamically according to the selection type (see also the "Selections" section). ## 8.1) "Figure" objects parameters ### 8.1.1) "Size" tab !(/media/images10.png) **Width (px)** : sets the size of the selected figure(s) in pixels **Width (cm)** : sets the size of the selected figure(s) in cm **Width (cols)** : sets the size of the selected figure(s) in journal columns (requires a journal style to be selected). If no journal style is selected 2 cols = 21cm, 1.5 col = 15.75cm and one col = 10.5 cm. **Space between rows** : sets the space between selected figure(s) rows in pixels ### 8.1.2) "Labels" tab !(/media/images43.png) **1st letter** : put the first letter of the selected figure here and hit "Enter" on your keyboard or press the "Update letters" to get your figure letters incremented automatically. Tip : if you put a space instead of a letter then letters from the selected Figure will be removed. **Add Legend** : Adds a text field/legend text row at the end of the selected figure (the text is wrapped automatically) and behaves as a row object. ### 8.1.3) "Layout" tab (only available in free mode) !(/media/images48.png) **Pack/Stack **: select several figures and press this button to pack these figures close to each other. **Align** : alignment functionality (similar to that in other software). Aligns objects top, bottom, left or right. **bring to front** : brings selection to front (in "free" mode, figures can overlap, it is therefore important to know which figure should be drawn above the others). **send to back** : sends selection to back (in "free" mode, figures can overlap, it is therefore important to know which figure should be drawn above the others). ### 8.1.4) "Misc" tab !(/media/images44.png) **Create a Figure or a Row with an empty image **: creates a Figure that just contains an empty image. You may use this empty image to draw arrows to logically connect independent figure objects. ## .2) "Row" objects parameters ### .2.1) "Size" tab !(/media/images45.png) **Width (px)** : sets the size of the selected row(s) in pixels **Width (cm)** : sets the size of the selected row(s) in cm **Width (cols)** : sets the size of the selected row(s) in journal columns (requires a journal style to be selected). If no journal style is selected 2 cols = 21cm, 1.5 col = 15.75cm and one col = 10.5 cm. **Space between panels**: sets the space (in pixels) between panels and images in the selected rows ### 8.2.2) "Labels" tab !(/media/images46.png) !(/media/images47.png) Below are the row specific labels. **+ letters outside** : adds a letter or some text outside the row. **+ text labels above images** : adds text above a row. **+ text labels below images** : adds text below a row. **+ text labels on the left** : adds text left of a row. **+ text labels on the right** : adds text right of a row.. ## 8.3) "Panel/Montage" objects parameters ### 8.3.1) "Layout" tab !(/media/images54.png) **Number Of Rows** : sets the number of rows of the panel (a panel is a 2D table of images). **Number of Columns** : sets the number of columns of the panel. NB : if **Number Of Rows \* Number of Columns < Number of Images contained in the panel**, no change will be made to the panel layout and an error message will be displayed. In that case increasing the numbers of rows or columns or both should get rid of the error message. **Order** : defines the order of images in a panel, i.e. should panels be filled horizontally before or after being filled vertically. **Space between images** : sets the space (in pixels) between panel images ### 8.3.2) "AutoCrops" tab !(/media/images55.png) Since **panels** are containers that **"*should"*** contain only images of the **same size** (or same **aspect ratio**) and that might not always be the case, "**AutoCrops**" contains tools to automatically crop images so that they end up having the same size or the same aspect ratio. **Force Same AR** : Force all images contained in the selected panel to have a user defined aspect ratio (to find which AR to use, select a single image with the desired aspect ratio. EZFig will then display the aspect ratio as well as image width and height). **Force Same Width & Height** : crops all images in the panel to have them have the same width and height, i.e. have the same size (this achieves a similar result as the **Force Same AR** function but is likely to crop the images much more, most often you should prefer the **Force Same AR** function). **Force Same Height** : force all images in the panel to have the same height . **This does not mean they will have the same AR, so the panel may still look weird.** **Force Same Width** : force all images in the panel to have the same width. **This does not mean they will have the same AR, so the panel may still look weird.** **Reset Crops** : reset crops for all images in the panel, useful if you made a mistake. ## 8.4) "Image/ImagePlus/Stack/Graph/Vector Image" objects parameters ### 8.4.1) "Labels" tab !(/media/images49.png) **+ text, scalebar, inset** : Use this to annotate an image, e.g. add letter or text at predefined positions on the image, add scale bars, add/remove insets, set inset size, add comments to the image. (See also the "Annotating images" section). **+ ROIs, arrows, text,...** : Use this to draw ROIs (rectangles, arrows, ellipses, ...), visually crop your image, or visually define an inset for the current image. (See also the "Annotating images" section). **- ROIS, arrows, ...** : Removes all ROIs from the selected images. ### 8.4.2) "Crop" tab !(/media/images50.png) **Left** : defines by which amount the image must be cropped from the left **Right** : defines by which amount the image must be cropped from the right **Up** : defines by which amount the image must be cropped from the top **Down** : defines by which amount the image must be cropped from the bottom NB: Crops can be used to change image size or aspect ratio, to fit images in panels. Crops can be used to focus on the most interesting region of the image, ... Note that the cropped regions are still available in EZFig, they are not discarded, they are just not shown. **Reset Crops** : resets crops for selected images. **Same Width** : force selected images to have the same width. **Same Height** : force selected images to have the same height. **Same Width & Height** : force selected images to have same width and height. **Same AR** : Force aspect ratio for the selected images. ### 8.4.3) "Orientation/Rotation" tab !(/media/images51.png) **Rotate (°)** : Rotate selected images by some user defined number of degrees (a rotated image is displayed interpolated for all rotation except 0°) **Left** : Rotate selected images by 90° to the left (rotated images are not interpolated) **Right** : Rotate selected images by 90° to the right (rotated images are not interpolated) **Flip** : Flip selected images along the horizontal or vertical axis or both axes (flipped images are not interpolated) ### 8.4.4) "Stack/Video" tab !(/media/images52.png) The "Stack/Video" tab is only enabled if the selected image is an ImagePlus or an ImagePlus stack (see the "Imports" section). **Slice** : select the displayed Z slice/section (NB: if the ImagePlus only contains slices but no frames, EZFig assumes slices are in fact frames). **Frame** : select the displayed t frame. **FPS** : define the fps for video outputs **Add Frame** : add a frame to the current stack (this should only be used to add label frames to a figure that will be exported as a movie). **Remove Frame** : removes a frame from the selected stack (it is in fact not removed from the ImagePlus but will not be accessible to EZFig anymore). **+Time** : Adds a time label to a video/stack **-Time** : remove time labels. **Ch** : show image channel informations. Activate/deactivate or change channel colours there. **To composite** : Convert RGB image to composite image. Most often it is recommended to import ImagePlus/Stack directly from ImageJ (see the "Imports" section). ### 8.4.5) "Misc" tab !(/media/images53.png) **Make The Selected Image Color Blind Friendly/Split Channels** : splits the image to individual gray channels or to pairwise (magenta/green) combinations of channels. This is useful to make the figure colour blind friendly. !(/media/images66.png) Select an image (left arrow). Select the "Misc" tab. Press "Split channels". !(/media/images67.png) Select "Single gray channels and merge" to split image into gray channels and merge. Or press "Magenta green combinations and merge" to get pairwaise (magenta/green) combinations of channels and merge (Select the image and press the "Del" or "Suppr" keyboard keys to remove unwanted combinations). See below for the result of the two types of outputs. !(/media/images68.png) !(/media/images69.png) # 9) Figure layout ## 9.1) Change figure size !(/media/image26.png) Press ⌃ Ctrl / ⌘ ⌃ Ctrl on a PC ⌘ command on a Mac + A to select all elements of the figure. !(/media/image27.png) Select the "Size" tab. Click on "1,5" to set the figure width to 1,5 columns of the selected journal style. !(/media/image28.png) Note that the figure that was initially 2 columns in size (materialized by the green rectangle, upper arrow) is now 1.5 columns in size (materialized by the yellow rectangle, lower arrow). !(/media/image29.png) You can also set the size of the figure in cm (arrow) or in pixels. ## 9.2) Change layout The most efficient way to change figure layout is as follows. !(/media/image30.png) Select the object to be moved, for example a row of the figure (arrow, labelled in cyan). Then press the ↑ Up or ← Left arrow to move the row up. (Press the → Right or ↓ Down arrows to move a row down). !(/media/image31.png) The whole row moved up. !(/media/image32.png) To move an inner component of the row, click on it until it gets selected (arrow) (see also "Selections" Section). Then press the keyboard "up" or "left" arrow to move an image left (Press the keyboard "down" or "right" arrow to move an image right). !(/media/image33.png) The two closest images have been swapped (arrows). # 10) Annotating Images ## 10.1) Add letters, labels and scalebar to an image !(/media/image13.png) Click on an image until you see a red selection around it (left arrow). Most likely you will have to click more than one time (see the "Selections" Section). Upon selection, the image menu appears (middle arrow). Select the "Label" panel then click on the "+Text, scale-bar, ..." button (right arrow). !(/media/image14.png) A menu will appear. Type text, add letters and scale-bars to an image from there. !(/media/image15.png) Select "Upper Left corner" to add text at the upper left corner of the image (top arrow), then type some text (bottom arrow). The text is displayed while you write on the original image (arrowhead). !(/media/image16.png) To add a scale bar, select "Scale Bar" (top arrow), set scale bar size (middle arrow), then set scale bar colour (bottom arrow). The scale bar is displayed dynamically on the original image (arrowhead). ## 10.2) Add ROIs/Floating text labels to an image !(/media/image17.png) Click on an image until you see a red selection around it (left arrow), you will most likely have to click more than one time (see the " Selections" Section). Upon image selection, the image menu appears (middle arrow). Select the "Label" panel then click on the "+ROIs, arrows, text, ..." button (right arrow). !(/media/image18.png) A new dialog appears that lets you draw ROIs or add floating text to the image. Press "Ok" when done (arrow) and the ROI will be added to the original image. (ROIs can be further edited if needed). ## 10.3) Convert ROIs to crop or insets (Picture In Picture, PIP) Open the ROI dialog for the image as described in the previous section. !(/media/image19.png) Draw two ROIs (red arrows). Select the biggest ROI by clicking on it. !(/media/image20.png) Press "ROI → Crop(s)" (right arrow) and an information message will appear upon successful conversion (left arrow). A crop corresponding to the ROI is added to the original image, see after. !(/media/image21.png) Select the second ROI by clicking on it (left arrow). Then press "ROIs → inset/PIP" (right arrow). A validation message shows upon success. Press "Ok" to close the dialog, then press "Ok" again to close the ROI dialog. !(/media/image22.png) An inset appears at the top right region of the image (the inset can be moved and resized). !(/media/image23.png) Also a crop corresponding to the biggest rectangle is added as a new row (arrow) at the end of the figure. ## 10.4) Add labels outside images/rows !(/media/images62.png) Select a row, the selection should be surrounded by a cyan rectangle (left arrow) (see also the "Selections" section). Then select the "Labels" tab (right arrow). !(/media/images63.png) Press "+ text labels above images" (right most arrow). Select "1" for begin and end (middle arrows). This means the label will be over the first image of the row only. Type in your text (bottom arrow). !(/media/images64.png) Press "Add" (bottom arrow). Set begin to "2" and end to "3" (upper arrows), this means the label will span over the second and third images in the row. Type in your text (middle arrow). !(/media/images65.png) Labels have been added above images. Labels can also be added left, right and below rows. # 11) Keep for later Often one needs to hide/remove portions of figures that are not yet finalized, however this unfinished work must still be kept somewhere in order to be added back later. This is what the "Keep For Later" menu is for. !(/media/image45.png) Select the object(s) to remove temporarily/hide from the figure. In this example, I selected the bottom right image (lower arrow). Press Keep For Later › Keep current selection for later (upper arrow). !(/media/image46.png) Note that the selected image is removed (lower arrow) from the row and added to the "Keep For Later" menu as a button (middle arrow). Note also that the "Keep for later" menu turns red when it contains something (upper arrow). !(/media/image47.png) Pressing the icon button in the "Keep For Later" menu adds the image back to the end of the figure. # 12) Manipulate image channels ## 12.1) Select or create an image with channels Load an image that contains channels, or import one from ImageJ (see the "Imports" section) and select it (see the "Selections" section). !(/media/image54.png) If there are no channels available in the "Ch" panel (upper arrow), you can convert an RGB image to composite by pressing the "To composite" button (lower arrow). !(/media/image55.png) Once the image is composite, its channels are displayed in the "Ch" panel. ## 12.2) Activate/inactivate channels !(/media/image56.png) "ch1" is active (ticked) !(/media/image57.png) Untick the channel (right arrow) and it becomes inactive in the image (left arrow). ## 12.3) Change channel colour !(/media/image58.png) Make sure "ch1" is active (ticked) !(/media/image59.png) Press the yellow button "Y" (right arrow) to turn the green channel to a yellow one. See the channel colour change on the image (left arrow). # 13) Use drag and drop to build a figure efficiently ## 13.1) Add inset using drag and drop The easiest way to add an inset or do anything in EZFig is via mouse **drag and drops**. !(/media/image63.png) Select an image and drag and drop it onto another image above it. !(/media/image64.png) Drop it !(/media/image65.png) A dialog opens. Select "Add dragged selection as inset" !(/media/image66.png) The inset is added to the image. ## 13.2) Add an image to a row !(/media/image67.png) Click on an image until it gets selected (i.e. surrounded by a red rectangle) (see the "Selections" section) (arrow). !(/media/image68.png) Drag and drop the image onto the row above it (notice the drop target becomes surrounded by a cyan rectangle). !(/media/image69.png) A dialog opens. Select "add dragged selection to the dropped target row". !(/media/image70.png) The image is added to the row. ## 13.3) Create a new row from an image/remove an image from a row !(/media/image71.png) Click on an image until it gets selected (surrounded by a red rectangle) (arrow). !(/media/image72.png) Drop the image into an empty region. !(/media/image73.png) A dialog opens. Select "Add selection to new row" and press "Ok". !(/media/image74.png) The image is added to a new row.
PS : to delete an image from the figure just select it (red selection) and press the "Del/Suppr" key on the keyboard.## 13.4) Create a panel, add it to a row and change its layout !(/media/image75.png) Click on an image until it gets surrounded by a red rectangle (arrow). !(/media/image76.png) **Duplicate it** (i.e. press ⌃ Ctrl / ⌘ ⌃ Ctrl on a PC ⌘ command on a Mac + C, ⌃ Ctrl / ⌘ ⌃ Ctrl on a PC ⌘ command on a Mac + V) five times (you should have 6 times the same image in your figure). Here I have six identical leaf image but things would work the same with non identical images having the same aspect ratio (e.g. images in a time series, Z slices, ...). !(/media/image84.png) Select one of the copied images and drop it onto the parent image in the first row. !(/media/image85.png) A dialog opens, select "Add selection to a panel" !(/media/image77.png) Note that a panel/montage containing two images has been added to the first row of the figure (arrow). !(/media/image79.png) Select one of the copied images, maintain the ⌃ Ctrl / ⌘ ⌃ Ctrl on a PC ⌘ command on a Mac keyboard key and click on the three other copied images (⌃ Ctrl / ⌘ ⌃ Ctrl on a PC ⌘ command on a Mac + leftclick allows for multiple selection). Note the cyan (or red) rectangles indicating the selected images (arrows). !(/media/image78.png) Drag and drop those four images onto the panel already containing 2 images. !(/media/image80.png) A dialog pops. Select "Add selection to a panel" and press "Ok". !(/media/image81.png) A panel with six images is now added to the first figure row. Select this panel, it should be surrounded by a magenta rectangle and display the "Panel" label (See also the "Selections" section). !(/media/image82.png) Change the number of rows to 3 (upper arrow) and the number of columns to 2 (lower arrow). Note that the layout of the panel is changed accordingly. ## 13.5) List of DND options and their use **Add dragged selection to the drop target row** : Adds dragged objects to the drop target row. **Add selection to new row** : Adds dragged objects to a new row in the figure. **Add selection to new Figure** : Adds dragged objects to a new figure (Free mode only). **Add selection as a new Row at the end of the drop target Figure : **Adds dragged objects as a new row in the drop target figure (Free mode only). **Add selection as new Rows at the end of the drop target Figure** : Adds dragged objects as new rows in the drop target figure (Free mode only). **Add selected Figure(s) content to the drop target Figure** : Adds the content of the dragged figures to the single drop target figure (i.e. fuse figures) (Free mode only). **Swap dragged selection with drop target** : Swap dragged object with drop target object of the same type (i.e. swap a figure with another one, a row with a row, a panel with a panel, ...). **Replace and remove the image in the drop target by that of the dragged image** : Replace drop target image by the dragged image (Be careful, the drop target image will be deleted). **Add selection to a panel (or create a panel)** : Create a panel that contains the dragged images and the drop target image/panel (image order and panel layout can be changed later). **Add dragged selection as inset (picture in picture/PIP) to the drop target image** : adds dragged selection as an inset in the drop target image. # 14) Add inset/Picture in picture (PIP) from the local drive !(/media/image60.png) Select an image (left arrow), select the "Labels" tab (middle arrow) then press the "+text, scalebar, inset" button !(/media/image61.png) Press the "Add/Replace Inset" button to insert an image from the local hard drive (Left arrow). Note that it is only possible to add one inset per image, note also that many journals ask not to use insets. To remove the inset associated with the image press "Remove Inset" (right arrow). !(/media/image62.png) Note that removed insets are not deleted, they are added to the "Keep For Later" menu (arrow) (See also the "Keep for Later" section). # 15) Journal styles ## 15.1) Select a journal style !(/media/images8.png) Before performing an editorial check you must always select a journal style first (arrow) !(/media/images9.png) If the journal you look for is not available you can create your own journal style (See after). ## 15.2) Create a new journal style !(/media/images11.png) Press Journals › Create new Journal !(/media/image25.png) Enter the journal parameters based on the journal guidelines such as size of a column, size of 2 columns, fonts to use, letter capitalization rules, style rules, text formatting rules, graph rules, ... Provide the name of the journal and it's all set. Please do not hesitate to send me the journal style you generate so that I can add it to EZFig, you'll be credited for this journal and you may really help other people. # 16) Editorial Checks When submitting a manuscript to a journal one needs to obey several editorial guidelines. EZFig can help you. ## 16.1) Check Size !(/media/images14.png) Select a journal style !(/media/images15.png) To check image size, i.e. that the created figure fits the journal style guidelines, press Checks › Size. !(/media/images12.png) A dialog pops and offers to change the size of the image to the closest available column journal size, feel free to accept or reject the offered solution. !(/media/images13.png) Upon acceptance, the image is resized (in that case the image has been resized to two journal columns as indicated by the alignment of the figure with the green rectangle on the drawing panel). ## 16.2) Check style Most journal have stylistic guidelines, for example the text should not be coloured. To check a figure for style : Select a journal style !(/media/images16.png) Press Checks › Style. !(/media/image83.png) The dialog shows the problematic image styles and offers a solution. Here, it offers to replace multicolour text by white text. Please feel free to accept or reject this suggestion. ## 16.3) Check Fonts Most journals ask to use a specific font and font size for the text, lettering and text annotations. To check figure for Fonts : !(/media/images17.png) Select a journal style !(/media/images20.png) Select "Fonts" in the "Checks" menu !(/media/images18.png) if the fonts do not respect journal guidelines, you will be offered to replace fonts. Feel free to accept or reject the offer. !(/media/images19.png) Upon acceptance, all fonts will be changed and EZFig will take care of the text layout for you. ## 16.4) Check line arts Most journals ask to have specific line width for ROIs and figire line arts, to check figure line arts : !(/media/images21.png) Select a journal style !(/media/images23.png) Select "Line arts" in the "Checks" menu. !(/media/images22.png) If line arts are not in conformity with the journal guidelines you will be offered a replacement solution. Feel free to accept it or not. !(/media/images24.png) Upon acceptance, line arts width is changed. ## 16.5) Check Text Journals have naming conventions text, for example they dictate how to write speed units should be written, ... To check the figure text : !(/media/images25.png) Select a journal style then press Checks › Text !(/media/images26.png) If the text did not pass the test, a solution will be offered. Feel free to accept it or reject it. Please pay attention to the offered solutions as text checks are irreversible, are programmatically hard to implement and thereby require careful human inspection. ## 16.6) Check Graphs Most journals have guideline regarding graphs (for example regarding units, background colours, ...). To check graphs (please note that EZFig can only check graphs generated with FiguR, a tool included in the EZFig package) : !(/media/images27.png) Select a journal style (left arrow) and ensure that EZFig is connected to R (green button, right arrow) !(/media/images28.png) Press Checks › Graphs !(/media/images29.png) Read the comments regarding your graph, perform changes or ignore suggestions if you think they are not appropriate. If you accept the solution your graphs will be changed (most changes are irreversible). # 17) FiguR Often figures contain graphs and FiguR is a tool to create graphs that can be directly edited by EZFig. FiguR uses R and ggplot2 to draw graphs. The use of ggplot2 is motivated by the fact that this is the only R library (as far as I know) where fonts can be set. Proper font is mandatory for most scientific publications. ## 17.1) Install and configure R (required for FiguR to work) !(/media/image6.png) Press Help › Show R installation guidelines !(/media/image5.png) A dialog opens. Please follow the instructions within. !(/media/image50.png) Finally launch R and type in (or more simply just copy-paste) the following three lines :
if ('Rserve' %in% rownames(installed.packages())==FALSE) install.packages('Rserve')
Rserve(args='—vanilla')!(/media/image51.png) To connect EZFig to R, press the red "R con" button in EZFig. !(/media/image52.png) If connection to R is successful, the "R con" button should turn green. !(/media/image53.png)
Similarly, to connect FiguR to R press the "R status" button (arrow) in FiguR.## 17.2) Launch FiguR !(/media/image3.png) To Launch FiguR from EZFig press FiguR › Launch FiguR !(/media/image4.png) The FiguR interface opens # 18) Settings !(/media/image7.png) Press Edit › Software Preferences !(/media/image8.png) A dialog opens. ## 18.1) Undos/Redos Undos/Redos are not active by default in SF. !(/media/image9.png) Press Edit › Software Preferences !(/media/image10.png) !(/media/image11.png) Tick the first checkbox to activate undos/redos !(/media/image12.png) When changes are made to the figure two new buttons will become visible and clickable (arrow). These buttons are the undo and redo buttons. ## 18.2) Shortcuts !(/media/image24.png) To edit EZFig shortcuts select Help › Shortcuts !(/media/image35.png) A dialog opens, click a shortcut to edit it. Press "Ok" when done. Nb : you can also reset shortcuts to default from this dialog.