Difference between revisions of "Team:Slovenia/Software"

 
(7 intermediate revisions by 3 users not shown)
Line 28: Line 28:
 
                         <b>Modeling of ultrasound</b>
 
                         <b>Modeling of ultrasound</b>
 
                     </a>
 
                     </a>
 +
                    <a class="item" href="//2016.igem.org/Team:Slovenia/Software" style="color:#DB2828">
 +
                        <i class="selected radio icon"></i>
 +
                        <b>CaPTURE software</b>
 +
                    </a>
 
                     <a class="item" href="#ach" style="margin-left: 10%">
 
                     <a class="item" href="#ach" style="margin-left: 10%">
 
                         <i class="selected radio icon"></i>
 
                         <i class="selected radio icon"></i>
Line 61: Line 65:
 
                 <!-- menu goes here -->
 
                 <!-- menu goes here -->
 
                 <div class="main ui citing justified container">
 
                 <div class="main ui citing justified container">
<h1 class = "ui left dividing header"><span class="section">&nbsp;</span>CaPTURE software for Ca influx analysis </h1>
+
<h1 class = "ui left dividing header"><span class="section colorize">&nbsp;</span>CaPTURE software for Ca influx analysis </h1>
 
<div class = "ui segment" style = "background-color: #ebc7c7; ">
 
<div class = "ui segment" style = "background-color: #ebc7c7; ">
<h4><span id = "ach" class = "section"></span></h4>
+
<p><span id = "ach" class = "section colorize"></span></p>
<p><ul>
+
<p><b><ul>
 
<li>Digital image analysis software was designed to quantify the cellular response to ultrasound.
 
<li>Digital image analysis software was designed to quantify the cellular response to ultrasound.
 
<li>The software automatically scans for response regions using the sliding window technique
 
<li>The software automatically scans for response regions using the sliding window technique
</ul></p>
+
<li>The source is available under GNU general public licence on <a href="//github.com/zigapusnik/CaPTURE">GitHub</a>.
 +
</b></ul></p>
 
</div>
 
</div>
 
<div class = "ui segment">
 
<div class = "ui segment">
 
<div>
 
<div>
<h4><span id="des" class="section"> &nbsp; </span></h4>
+
<h4><span id="des" class="section colorize"> &nbsp; </span></h4>
<p>CaPTURE software was developed by the Slovenian 2016 iGEM team with an aim to analyze the calcium influx into mammalian cells upon ultrasound stimulation of mechanosensitive channels detected by the fluorescence microscopy. CaPTURE analyses the digital images from the confocal microscope to detect the cellular response to stimulation by change of the fluorescence. Software calculates the ratio of the fluorescence in two channels and it automatically scans for the response regions using the sliding window technique and provides the temporal response of cells. Track of each cell can be monitored or average calculated and different threshold and selection criteria can be set. The software was prepared for our Sonicell project, but it can be used for virtually any time dependent images the synthetic biology community.  
+
<p>CaPTURE software was developed by the Slovenian 2016 iGEM team with an aim to analyze the calcium influx into mammalian cells upon ultrasound  
 +
stimulation of mechanosensitive channels detected by the fluorescence microscopy. CaPTURE analyses the digital images from the confocal microscope  
 +
to detect the cellular response to stimulation by change of the fluorescence. Software calculates the ratio of the fluorescence in two channels and  
 +
it automatically scans for the response regions using the sliding window technique and provides the temporal response of cells. Track of each cell  
 +
can be monitored or average calculated and different threshold and selection criteria can be set. The software was prepared for our Sonicell project,  
 +
but it can be used for virtually any time dependent images the synthetic biology community.  
 
</p>
 
</p>
 
<div align="center">
 
<div align="center">
<video width="600" controls>
+
<video width="60%" controls>
 
<source src="//2016.igem.org/wiki/images/e/e1/T--Slovenia--CAPTUREFINALTAKE.mp4"
 
<source src="//2016.igem.org/wiki/images/e/e1/T--Slovenia--CAPTUREFINALTAKE.mp4"
 
type="video/mp4">
 
type="video/mp4">
Line 83: Line 93:
 
</div>
 
</div>
 
<div>
 
<div>
<h3><span id="req" class="section"> &nbsp; </span> System requirements </h3>
+
<h3><span id="req" class="section colorize"> &nbsp; </span> System requirements </h3>
 
<p>CaPTURE runs on any system equipped with the Java Virtual Machine (1.7 or newer), which can be
 
<p>CaPTURE runs on any system equipped with the Java Virtual Machine (1.7 or newer), which can be
 
downloaded at no
 
downloaded at no
Line 90: Line 100:
 
</div>
 
</div>
 
<div>   
 
<div>   
<h3><span id="install"  class="section"> &nbsp; </span> Installing and running </h3>
+
<h3><span id="install"  class="section colorize"> &nbsp; </span> Installing and running </h3>
 
<p> Download the <a href="//2016.igem.org/wiki/images/8/8f/T--Slovenia--CaPTURE.zip">CaPTURE folder</a>
 
<p> Download the <a href="//2016.igem.org/wiki/images/8/8f/T--Slovenia--CaPTURE.zip">CaPTURE folder</a>
 
and unzip it. CaPTURE is also available on <a href="//github.com/zigapusnik/CaPTURE">GitHub</a>. The simplest way to run the program is by double
 
and unzip it. CaPTURE is also available on <a href="//github.com/zigapusnik/CaPTURE">GitHub</a>. The simplest way to run the program is by double
Line 114: Line 124:
 
</div>
 
</div>
 
<div>
 
<div>
<h3><span id="build"  class="section"> &nbsp; </span> Building from source </h3>
+
<h3><span id="build"  class="section colorize"> &nbsp; </span> Building from source </h3>
 
<p>
 
<p>
 
To build the application from source, follow the given steps: </p>
 
To build the application from source, follow the given steps: </p>
Line 145: Line 155:
 
</div>
 
</div>
 
<div>
 
<div>
<h3><span id="faq"  class="section">&nbsp; </span> FAQ</h3>
+
<h3><span id="faq"  class="section colorize">&nbsp; </span> FAQ</h3>
 
<h5> I tried to open a file, but CaPTURE froze during the processing. What should I
 
<h5> I tried to open a file, but CaPTURE froze during the processing. What should I
 
do? </h5>
 
do? </h5>
<p> Most likely your JVM ran out of memory. While it is not possible to addres more than 4GB with 32
+
<p> Most likely your JVM ran out of memory. While it is not possible to address more than 4GB with 32
bit Java, 64 bit version is prefered. It is also possible to increase the maximum heap size
+
bit Java, 64 bit version is preferred. It is also possible to increase the maximum heap size
 
using the -Xmx switch. For maximum heap size of 1024 MB the following command should be executed
 
using the -Xmx switch. For maximum heap size of 1024 MB the following command should be executed
 
from the command line:
 
from the command line:
Line 178: Line 188:
 
         </div>
 
         </div>
 
     </div>
 
     </div>
 +
</div>
 +
<div>
 +
<a href="//igem.org/Main_Page">
 +
<img border="0" alt="iGEM" src="//2016.igem.org/wiki/images/8/84/T--Slovenia--logo_250x250.png" width="5%" style = "position: fixed; bottom:0%; right:1%;">
 +
</a>
 
</div>
 
</div>
 
</body>
 
</body>
 
</html>
 
</html>

Latest revision as of 14:26, 19 October 2016

Software

 CaPTURE software for Ca influx analysis

  • Digital image analysis software was designed to quantify the cellular response to ultrasound.
  • The software automatically scans for response regions using the sliding window technique
  • The source is available under GNU general public licence on GitHub.

 

CaPTURE software was developed by the Slovenian 2016 iGEM team with an aim to analyze the calcium influx into mammalian cells upon ultrasound stimulation of mechanosensitive channels detected by the fluorescence microscopy. CaPTURE analyses the digital images from the confocal microscope to detect the cellular response to stimulation by change of the fluorescence. Software calculates the ratio of the fluorescence in two channels and it automatically scans for the response regions using the sliding window technique and provides the temporal response of cells. Track of each cell can be monitored or average calculated and different threshold and selection criteria can be set. The software was prepared for our Sonicell project, but it can be used for virtually any time dependent images the synthetic biology community.

  System requirements

CaPTURE runs on any system equipped with the Java Virtual Machine (1.7 or newer), which can be downloaded at no cost from Oracle.

  Installing and running

Download the CaPTURE folder and unzip it. CaPTURE is also available on GitHub. The simplest way to run the program is by double clicking on the CaPTURE.jar file, however, it might not work on some systems. Alternatively, execute the program from the command line using the following command:

java -jar CaPTURE.jar

To run the application from the JAR file that is in another directory, you must specify the path of that directory:

java -jar path/CaPTURE.jar

Note that on Windows the forward slash as the directory separator should be replaced with a backslash. To test the software you can download the example .lif file. Extract the file and open it with CaPTURE.

  Building from source

To build the application from source, follow the given steps:

  • Download CaPTURE and unzip it.
  • Change the working directory to unzipped CaPTURE folder.
  • Then compile .java source files to executable .class files.
  • Copy bioformats_package.jar and icon.png resource file from the src directory in the scanPackage directory that was created during the compilation.
  • Create a single java archive file from multiple .class files.
  • Then you can start the program.

Linux & OS X:

cd CaPTURE
javac -d . -cp src/bioformats_package.jar src/*.java
cp src/icon.png scanPackage
jar cfm CaPTURE.jar MANIFEST.MF scanPackage
java -jar CaPTURE.jar

Windows:

cd CaPTURE
javac -d . -cp src\bioformats_package.jar src\*.java
robocopy src scanPackage icon.png
jar cfm CaPTURE.jar MANIFEST.MF scanPackage
java -jar CaPTURE.jar

  FAQ

I tried to open a file, but CaPTURE froze during the processing. What should I do?

Most likely your JVM ran out of memory. While it is not possible to address more than 4GB with 32 bit Java, 64 bit version is preferred. It is also possible to increase the maximum heap size using the -Xmx switch. For maximum heap size of 1024 MB the following command should be executed from the command line:

java -Xmx1024m -jar CaPTURE.jar
I want to open several files at the same time. How to do it?

Currently only one file can be loaded. You can, however, open a new instance of CaPTURE and analyze the second file in it.

I cannot open other microscopic file formats. Are other formats not supported?

Currently only .lif format is supported, however in the future CaPTURE will support other microscopic image formats.

I tried to compile the source using my OpenJDK implementation, but got the following error "TimeLineJForm.java:37: error: package javafx.stage does not exist".

OpenJFX is needed to compile the source code. For many platforms you can simply install (or update) JDK 8.