Saturday, August 30, 2014

Getting started

This is the introductory step in the tutorial Collecting 3D shape data using StereoMorph

1. If you do not already have R installed on your computer, begin by installing R. R can be installed on Windows, Linux and Mac OS X.

2. Open R.

3. In R, go to Packages & Data > Package Installer.

4. Find the StereoMorph package binary by typing “StereoMorph” into the Package Search box and clicking Get List.

5. Check the box next to Install Dependencies. This ensures that all the packages that StereoMorph requires to run will be installed as well. Then click Install Selected to install StereoMorph.

6. Download and unzip the StereoMorph Tutorial folder from StereoMorph Tutorial files (~63 MB). This folder contains all the files needed to perform the steps in this tutorial.

StereoMorph Tutorial files
7. Change the working directory in R to the StereoMorph Tutorial folder so that we easily access the files in R. Go to Misc > Change Working Directory....

8. Locate and select the unzipped StereoMorph Tutorial folder and click Open.

9. Load the StereoMorph package into the current R session using the library command.

> library(StereoMorph)

For the rest of this tutorial, text in Courier preceded by a “>” in the style above will be used to indicate commands to be entered into the R console. All of the R commands executed in this tutorial can be found in the ‘Tutorial code.R’ file in the Tutorial folder.

You are now ready to run all of the steps in the tutorial!

Go to the first tutorial step: Creating a checkerboard pattern


  1. Hiya...I am trying to apply this technique for my study in which I am trying to take photographs of bat skull. But I have a few queries on printing the check board pattern. I would like to know the paper size on which the checker board is printed and I didn't get the scaling that you are mentioning in that tutorial...Look forward to hearing from you...many thanks..

    1. Hi Anoob,

      You can print the checkerboard on the standard size of paper that will fit in your printer, 8.5" x 11" for example (US). By adjusting the scaling you can make the checkerboard smaller than the paper size and then just cut the paper down to size.

      The scaling formula that is shown on the "Measuring checkerboard square size" page might only be valid for certain printers, particularly US printers. If the scaling formula doesn't work then it's best to measure the checkerboard square size using the method described.

      I'm just finishing up major updates to StereoMorph (version 1.5) and will be releasing it on CRAN in the next week or two. The new version is much more user-friendly and includes a new tutorial and example project. I will post on the blog as soon as v1.5 is available - I hope that will be useful to you.