Don’t forget to cite!
tar -zxvf FPBioimage-x.x.x.tar.gz, then in the extracted folder run
ImageJ or FIJI
Images must be saved as a stack of PNG files.
The maximum resolution supported by FPBioimage is 500x500 pixels, and 500 images.
The smaller the image size, the shorter the loading time will be for those viewing your data.
To prepare volumetric imaging data for the viewer manually we recommend the use of ImageJ, an open-source imaging processing package. Whilst these instructions explain how to prepare your images using ImageJ, any image processing software which will prepare images to the specification above can be used.
The Scale function in ImageJ can be used to adjust the image stack to an appropriate size.
Before saving in PNG format, the data must be rendered as an RGB image. Do this by selecting Image ► Color ► Stack to RGB. Uncheck “Keep Source”, and click OK.
The stack can then be saved as PNG slices using File ► Save As ► Image Sequence, and selecting PNG as the Format.
FPBioimage runs on a webpage. In order to display volumetric data correctly the webpage requires some information about the data, for example the location of the images and the voxel size.
Modifying the provided website template
The simplest way to display your 3D data online is to modify the provided website template, which can be found on the download page.
You are free to modify and embellish the template webpage as you see fit for your website.
Creating your own webpage
The following JSON variable need to be defined in the header of the webpage (i.e. between the
||Path to the image stack folder relative to the folder containing the FPBioimage folder.|
||Defines a unique name. If two data sets share the same name on your website the bookmark behaviour may be unexpected.|
||The number of images in the image stack.|
||The images’ file names before the incrementing number.|
||Defines the format of the incrementing number in the images’ file names.|
||The x in the ratio of x:y:z voxel size.|
||The y in the ratio of x:y:z voxel size.|
||The z in the ratio of x:y:z voxel size.|
||This tells the webpage to use version 4 of FPBioimage.|
The FPBioimage viewer should be included in the body of the webpage using the following HTML snippet:
The height and width can be changed as required.
The last thing to be defined in the body of the webpage should be the code required to load FPBioimage into the viewer. This HTML snippet should come after all page elements, since it can take a few seconds to load and will halt loading of the rest of the webpage for this time. The required line of HTML is:
Note that if you want to preview the webpage offline on your local computer (i.e. not on a web server) you must set up a localhost server for FPBioimage to load images correctly.
We are very happy to provide further assistance to help you share your 3D data online. Email the developer at fpBioimage@gmail.com.
First Person Bioimage (FPBioimage) is distributed under the Creative Commons Attribution - ShareAlike 4.0 International license. This means that, providing you credit the original software appropriately, you are free to copy, redistribute, remix, transform and build upon the software, as long as future contributions are distributed under the same license.
If you use FPBioimage to publish work in an academic journal, please citation the original publication of the software in Nature Photonics.