Difference between revisions of "Team:Peking/Software"

Line 338: Line 338:
 
                                  
 
                                  
 
                                 <div class="content">
 
                                 <div class="content">
                                     <p>We produce abundant fluorescent images in our experiments. However, there are many troubles when taking into the processing those data. The data can be extremely large. Even if you just take a 1 hour imaging for 25 positions in 3 channel for every minutes, the microscope will yield 4500 high resolution images. To help with the image processing in such a high throughput, we developed a software aim at microscope images batching. <a href="https://github.com/igemsoftware2018/Team_Peking">(Github: https://github.com/igemsoftware2018/Team_Peking)</a>
+
                                     <p>We produce abundant fluorescence images in our experiments. However, there are many challenges in the processing of such data, which can be extremely large. Even in the case of 1 hour of imaging for 25 positions at 3 channels every minute, the microscope will yield 4500 high-resolution images. To help with the image processing in such a high throughput, we developed software for microscope image batching. <a href="https://github.com/igemsoftware2018/Team_Peking">(Github: https://github.com/igemsoftware2018/Team_Peking)</a>
 
<br/><br/>
 
<br/><br/>
 
<div align="center"><img src="https://static.igem.org/mediawiki/2018/5/52/T--Peking--Software.png" width="300 px" height="300 px"></div>
 
<div align="center"><img src="https://static.igem.org/mediawiki/2018/5/52/T--Peking--Software.png" width="300 px" height="300 px"></div>
Line 344: Line 344:
  
  
<p style="text-align:justify; text-justify:inter-ideograph">This software is wrote just for the problems we meet. </p>
+
<p style="text-align:justify; text-justify:inter-ideograph">This software was written specifically for the problems we encountered. </p>
 
</div>
 
</div>
 
</div>  
 
</div>  
Line 355: Line 355:
 
                                  
 
                                  
 
                                 <div class="content">
 
                                 <div class="content">
                                     <p>The first problem we meet is the file name of the exported images are always in massy rules. What’s the most confusing, the rules of number of the positions, channels and time are various in files. Considering the diversity of file names of images derived from different microscopes, we manage to build a naming rule manager, which can create and modify the name rule. The rules can be made are flexible, which can contain up to 4 variables and 4 customized string. Every variables have a customized zero filling function that can solve the problem like the annoying number 01 to 99. The users can also shear their rules in the form of a file, which may benefit group working.<a href="https://static.igem.org/mediawiki/2018/3/32/T--Peking--Users_manual.pdf"> Read the user's manuals for more detail.</a>  
+
                                     <p>The first problem we met is that the file names of the exported images are generated according to <b>fuzzy rules</b>. Confusingly, the rules for the number of the positions, channels and times vary among files. To address the diversity of file names of images derived from different microscopes, we managed to build a <b>naming rule manager</b>, which can create and modify the naming rule. The rules that can be made are <b>flexible</b>, and can contain up to 4 variables and 4 customized strings. Every variable has a customized zero filling function that can solve annoying problems such as the numbers 01 to 99. The users can also <b>share</b> their rules in the form of a file, which may benefit group projects.<a href="https://static.igem.org/mediawiki/2018/3/32/T--Peking--Users_manual.pdf"> Please refer to the user manuals for more details.</a>  
 
<br/><br/>
 
<br/><br/>
 
<div align="center"><img src="https://static.igem.org/mediawiki/2018/d/dd/T--Peking--Namerule.png"></div>
 
<div align="center"><img src="https://static.igem.org/mediawiki/2018/d/dd/T--Peking--Namerule.png"></div>
Line 371: Line 371:
 
                                  
 
                                  
 
                                 <div class="content">
 
                                 <div class="content">
                                     <p>After solving the problem of getting files, we can now stick to the practices functions practical.
+
                                     <p>After solving the problem of obtaining the files, we can now address their processing.The most important difference between fluorescence microscope images and ordinary photographs is the channel function. We needed to contrast different fluorescence channels to assess the result. However, exporting a great number of large images can be exceedingly time-consuming. Thus, if we can merge the channels or convert the images to grayscale after cropping, we will save much time. Thus, we added the functions of <b>merging</b> and <b>grayscale conversion</b> to our software first.<a href="https://static.igem.org/mediawiki/2018/3/32/T--Peking--Users_manual.pdf"> Please refer to the user manuals for more details.</a> </p>
The most important difference between fluorescent images of microscope and Ordinary photo is the function of channel. We need to contrast different fluorescent channel to discover the conclusion. However, export a large number of large images could be a time-wasting process. If we can merge channel or convert the images into grayscale after cropping, we will save much time. Thus we add the functions of merging and grayscale to our software first. <a href="https://static.igem.org/mediawiki/2018/3/32/T--Peking--Users_manual.pdf"> Read the user's manuals for more detail.</a> </p>
+
 
<br/><br/>
 
<br/><br/>
 
<div align="center"><img src="https://static.igem.org/mediawiki/2018/e/eb/T--Peking--GrayS.png" width="150 px" heigth="150 px">
 
<div align="center"><img src="https://static.igem.org/mediawiki/2018/e/eb/T--Peking--GrayS.png" width="150 px" heigth="150 px">
Line 388: Line 387:
 
                                  
 
                                  
 
                                 <div class="content">
 
                                 <div class="content">
                                     <p>For the living organism, if we want to show the dynamic process with video, we will need to fuse the images by order to make video. We wrote the functions to export video by time or by z axis. <a href="https://static.igem.org/mediawiki/2018/3/32/T--Peking--Users_manual.pdf"> Read the user's manuals for more detail.</a></p>
+
                                     <p>In living organisms, if we want to show dynamic processes using video recordings, we will need to fuse the images in the correct order to make a video. We therefore wrote functions to <b>export video</b> by time or by z axis. <a href="https://static.igem.org/mediawiki/2018/3/32/T--Peking--Users_manual.pdf"> Please refer to the user manuals for more details.</a> </p>
 
<br/><br/>
 
<br/><br/>
 
<div align="center">
 
<div align="center">
Line 422: Line 421:
 
                                  
 
                                  
 
                                 <div class="content">
 
                                 <div class="content">
                                     <p>What’s more, sometime the cells float in the process of photographing, which result in the cell drift or even rotate in the video. We will have to make a larger cropping to ensure the cell will not go out of the edge. To solve this problem, We wrote a function that can move the cropping frame with the cell linearly, which can fix the drift of cell to some extent. Also, we can rotate the image by the setting before cropping, by which we may also fix the rotation of the cells. <a href="https://static.igem.org/mediawiki/2018/3/32/T--Peking--Users_manual.pdf"> Read the user's manuals for more detail.</a> </p>
+
                                     <p>What’s more, sometime the cells float in the process of photographing, which result in the cell drift or even rotate in the video. We will have to make a larger cropping to ensure the cell will not go out of the edge. To solve this problem, We wrote a function that can move the cropping frame with the cell linearly, which can fix the drift of cell to some extent. Also, we can rotate the image by the setting before cropping, by which we may also fix the rotation of the cells. <a href="https://static.igem.org/mediawiki/2018/3/32/T--Peking--Users_manual.pdf"> Please refer to the user manuals for more details.</a> </p>
 
<br/><br/>
 
<br/><br/>
 
<div align="center">
 
<div align="center">
Line 444: Line 443:
 
                                  
 
                                  
 
                                 <div class="content">
 
                                 <div class="content">
                                     <p>Eventually, the microscopy images in science need some information on it before showing up in public. The time scale of every frame and the scale of the cell are the most common features. We can add the time scale information to the image by the given position, start time, interval and unit. And the scale plate, which indicate the scale of the cells, can be added by the given position, total length, length/pixel and unit.<a href="https://static.igem.org/mediawiki/2018/3/32/T--Peking--Users_manual.pdf"> Read the user's manuals for more detail.</a>  </p>
+
                                     <p>Eventually, the microscopy images in science need some information on it before showing up in public. The time scale of every frame and the scale of the cell are the most common features. We can add the time scale information to the image by the given position, start time, interval and unit. And the scale plate, which indicate the scale of the cells, can be added by the given position, total length, length/pixel and unit.<a href="https://static.igem.org/mediawiki/2018/3/32/T--Peking--Users_manual.pdf"> Please refer to the user manuals for more details.</a>  </p>
 
<br/><br/>
 
<br/><br/>
 
<div align="center">
 
<div align="center">

Revision as of 09:08, 16 October 2018

Home

Software

Overview

We produce abundant fluorescence images in our experiments. However, there are many challenges in the processing of such data, which can be extremely large. Even in the case of 1 hour of imaging for 25 positions at 3 channels every minute, the microscope will yield 4500 high-resolution images. To help with the image processing in such a high throughput, we developed software for microscope image batching. (Github: https://github.com/igemsoftware2018/Team_Peking)



This software was written specifically for the problems we encountered.

Naming Rules management

The first problem we met is that the file names of the exported images are generated according to fuzzy rules. Confusingly, the rules for the number of the positions, channels and times vary among files. To address the diversity of file names of images derived from different microscopes, we managed to build a naming rule manager, which can create and modify the naming rule. The rules that can be made are flexible, and can contain up to 4 variables and 4 customized strings. Every variable has a customized zero filling function that can solve annoying problems such as the numbers 01 to 99. The users can also share their rules in the form of a file, which may benefit group projects. Please refer to the user manuals for more details.



Grayscale and Channels Merge

After solving the problem of obtaining the files, we can now address their processing.The most important difference between fluorescence microscope images and ordinary photographs is the channel function. We needed to contrast different fluorescence channels to assess the result. However, exporting a great number of large images can be exceedingly time-consuming. Thus, if we can merge the channels or convert the images to grayscale after cropping, we will save much time. Thus, we added the functions of merging and grayscale conversion to our software first. Please refer to the user manuals for more details.





Video and Z Stacks

In living organisms, if we want to show dynamic processes using video recordings, we will need to fuse the images in the correct order to make a video. We therefore wrote functions to export video by time or by z axis. Please refer to the user manuals for more details.






Cropping

In science research, cropping are widely used to beautify the images and emphasize the target. To meet the need of flexible cropping, we provide two cropping method. Drawing cropping can draw the range to be cropped while position cropping crop straightly by the given position. Read the user manuals for more detail.





Fixing Drift and Rotation

What’s more, sometime the cells float in the process of photographing, which result in the cell drift or even rotate in the video. We will have to make a larger cropping to ensure the cell will not go out of the edge. To solve this problem, We wrote a function that can move the cropping frame with the cell linearly, which can fix the drift of cell to some extent. Also, we can rotate the image by the setting before cropping, by which we may also fix the rotation of the cells. Please refer to the user manuals for more details.







Time Scale and Scale Plate

Eventually, the microscopy images in science need some information on it before showing up in public. The time scale of every frame and the scale of the cell are the most common features. We can add the time scale information to the image by the given position, start time, interval and unit. And the scale plate, which indicate the scale of the cells, can be added by the given position, total length, length/pixel and unit. Please refer to the user manuals for more details.













Almost all of the microscopy image shown in our wiki and ppt are processing with this software. It help us a lot and we wish to share it with anyone who need it. If you want more detail, read the user manuals and the software are available here (Github).And if you want a update version after the project freeze after iGEM, click here (Github),we will release all the update here.