Skip to content

Latest commit

 

History

History
36 lines (29 loc) · 2.48 KB

README.md

File metadata and controls

36 lines (29 loc) · 2.48 KB

PuntoMorph Readme - PLEASE READ!

High content analysis of phagocytic activity and cell morphology

Installing the standalone executable on Windows

Download and run the PuntoMorph1.3.exe file to install PuntoMorph on your machine. This installer will prompt you to install the appropriate MATLAB runtime environment. Note that you will need a 64-bit Windows (and administrator access) to install the standalone software. Depending on the speed of your computer, PuntoMorph may take a few minutes to start the first time you run it. Please be patient.

Compiling standalone software for Mac or Linux

To compile a standalone executable for Mac and Linux, download the source code (including the MATLAB figure file) and the required m-files (see below) and compile on your local Mac or Linux machine. This can also be done for Windows.

Testing out your PuntoMorph installation

1- Download and unzip the sample image folder provided in the Github repository (demo_images.zip)
2- Run PuntoMorph
3- Point PuntoMorph's "Select Folder" button to select the folder containing the images (e.g. the folder you unzipped in #1)
4- Select the appropriate settings for your image format and color channels
5- Run PuntoMorph
6- Examine the output Analysis.txt file using a file editor (e.g. Wordpad) or spreadsheet editor (e.g. Excel)

General usage considerations

1- Ensure that images are of reasonable quality and resolution
2- Preferably include 30 or more valid cells per image to enable accurate exclusion of artifacts
3- For phagocytic analysis, avoid excessive clumping of bead objects
4- Examine the tracing overlay of analyzed images to identify potential errors
5- Use the parameters reported in the results file to apply additional filters
6- Every time you run the program on a folder, it will delete previous analysis and log files. If you want to save the output files from a previous run, move those files to a new folder before rerunning the program

Running PuntoMorph in MATLAB

If you plan to run PuntoMorph in MATLAB, download the PuntoMorph.m and PuntoMorph.fig files and place them in the path of your MATLAB installation. You will also need the following m-files (available from MATLAB File Exchange):

circle_hough.m
circle_houghpeaks.m
circlepoints.m
dlmcell.m
imoverlap.m
getfilenames.m

p.s. We advise replacing all instances of "strcmp" in getfilenames.m with "strcmpi"