Skip to content

mizutanilab/MCTrace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

53 Commits
 
 
 
 
 
 
 
 

Repository files navigation

MCTrace is a program for skeletonized model building and refinement with a graphical user interface. It consists of over 50,000 lines of custom source code in C++ and uses DirectX 9.0 API. MCTrace executable is available from the Releases pane of the repository homepage.

screenshot

Neuronal circuits, which are essential for brain functions, are built up by neurons as a 3D network, so tracing the 3D neuronal network of brain is the first step to understanding the mechanism of brain functions. We demonstrated that a skeletonized model of neuronal processes can be built by tracing the 3D coefficient map. An example of the obtained network model of human brain tissue using MCTrace is shown left. In this process, the 3D image was converted into 3D Cartesian coordinates by model building. The 3D coordinates are easier to handle than the image itself, making it possible to analyze the geometry of brain network. The entire 3D network of fly brain hemisphere appeared in MIT Technology Review were built with this software.

License

MCTrace is provided under the BSD 2-Clause License.

References

  • R. Mizutani et al (2021). Structural diverseness of neurons between brain areas and between cases. Transl. Psychiatry 11, 49. DOI pdf
  • R. Mizutaniet al (2019). Three-dimensional alteration of neurites in schizophrenia. Transl. Psychiatry 9, 85. DOI arXiv
  • First 3-D Map of a Fruit Fly’s Brain Network. MIT Technology Review (Sep 16, 2016). link
  • R. Mizutani et al (2013). Three-dimensional network of Drosophila brain hemisphere. J. Struct. Biol. 184(2), 271-279. DOI PubMed arXiv
  • R. Mizutani et al (2010). Microtomographic analysis of neuronal circuits of human brain. Cerebral Cortex 20(7), 1739-1748. DOI PubMed

Release notes

MCTrace executable 'kozo---.exe' is available from the Releases pane of the repository homepage. This page was previously posted in our lab site and moved from there in 2016.

  • Build Jan-16-2023. Executables compiled with VS2008 and VS2017 are both available.
  • Build Dec-25-2020. Functions including those for the analysis of vessel strucrures were implemented.
  • v3.8.0 (21 Mar 2018). Many functions including improved auto-tracing, structure annoation, geometry analysis, and SWC file loading routines were implemented. You can use MCTrace to view SWC files, such as those available from NeuroMorpho.Org.
  • v3.5.0 (6 Jan 2017) Routines for Bluetooth Dials were implemented.
  • v3.4.1 (2 Nov 2016). Bug fix release.
  • v3.4.0 (built 1 Apr 2016). Many functions including those for the left-hand mouse were implemented.
  • v3.2.8 (built 27 May 2013). x64 platform is now supported. Functions for crystallographic analysis were disabled and not supported from this release.
  • v2.2.1 (relesed 6 Dec 2010). Graphics are accelerated with DirectX libraries. Functions for microtomographic analysis were thoroughly updated.
  • v2.0.2 (released 9 Jun 2009). Functions for tomographic analysis were implemented.
  • v1.0.2 (released 9 Jan 2007). Cut, copy and paste functions were debugged. Refinement dialog was updated. Users now can specify regions to be refined.
  • v1.0.1 (released 12 Dec 2006). Cut, copy and paste functions were implemented. Exponential subroutine was replaced with a custom one. This makes the structure factor calculation over three times faster than before.
  • v1.0.0 is released (12 Nov 2006).

How to use

We believe that this program is self-explanatory. The following tips might be helpful.

Installation
Place the MCTrace executable to any folder you like. If you use the exe compiled with VS2008 (such as that compiled on Jun 2021), you may need "Microsoft Visual C++ 2008 SP1 Redistributable Package" available from the MS official site.

Execution
Double click the 'MCTrace' executable.

Open model
From the menu bar, select 'File'-'Open' and choose a coordinate file. Click the 'OK' button. Double-click a node to highlight it and select 'Focus' from the right click menu. This will bring the highlighted node to the center of the window. You can focus on any particular part of the model by selecting 'View'-'Focus'. If you have no model coordinate, 'File'-'New' generates a new model.

Three-dimensional coefficient map
Select 'Model building'-'Load slices' to load tomographic slices in TIFF format. After the map files were loaded, open the map dialog from the 'Model building'-'Coeff map' menu, select 'Generate new map', and enter parameters of 'CT mesh' and 'Display' region. Enable one of map 'Contours' and set an approriate contour level in 'sigma' (standard deviation of your map). A recommended value of the contour level is '3'. 'Apply' invokes the map update.

Modify model
First, double click the model to be modified, deleted, or otherwise manipulated. Select 'Edit'-'Delete' to delete part of the model or 'Move' to rotate or translate. The double-clicked node can be moved by mouse dragging.

Statistical analysis
The 'Analyze' menu provides a number of analysis tools.

Refinement
Open the 'Model building'-'Refine' dialog. Enter appropriate parameters for dynamics and/or minimization calculation. 'Start' executes refinement. Models under refinement are dynamically displayed and can be manipulated.

Frequently asked questions

  1. System requirements
  2. MCTrace runs on most of Windows laptop and desktop PCs.

  3. Manuals
  4. We have no manuals appropriate for the current version.

Contact

Ryuta Mizutani, Dr., Prof.
Department of Applied Biochemistry
School of Engineering, Tokai University
Kitakaname 4-1-1, Hiratsuka, Kanagawa 259-1292, Japan
E-mail mizutanilaboratory(at)gmail.com
https://mizutanilab.github.io/
Linkedin - YouTube