Monday 29 January 2024

Fiji plugin to read Xradia files

Translator


This is a plugin for Fiji (ImageJ) that reads 
*.xrm*.txrm, and *.txm image files (from Xradia XRM systems, in their proprietary format, a form of OLE container) and opens them as image stacks, along with a text window displaying some metadata parameters. Download the .zip folder and just drop the two jar files (poi-3.7.jar and XRM_Reader.jar) onto the Fiji main window.  The program will put them in the right place. Restart Fiji and you should find it under 

Plugins > XRM_Reader

https://doi.org/10.5281/zenodo.10580258



I modified the above plugin from this one:
https://github.com/mrsutherland/XRM_Reader/releases  by mrsutherland, released 14 Nov 2017 

 

The folder at Zenodo also contains an ImageJ macro (XRM_files_thumbnails-6-3.ijm) for making a thumbnail image and metadata text file for every Xradia-format image in a folder. This is in the ImageJ macro language and requires the XRM_Thumbnails plugin, also included in the same archive. (This will appear in the plugins menu but isn't meant to be run on its own.)

 

I made this macro to help survey and index the many hundreds of Xradia scan files that have accumulated on my storage server. The script automatically processes a directory and its subdirectories, leaving an easily readable thumbnail image and metadata file with the same filename base as each unpreviewable *.xrm*.txrm, or *.txm image file. 

 

This version is working pretty well, and it makes an XYZ montage for each reconstructed stack and a 0°- 90° mugshot for each projection series (really first and middle projection - for a 360° scan it will be front and back images). I have not figured out how to read the date/time from the xrm files. 

 

A current version of the thumbnails macro can be found here: https://ucloud.univie.ac.at/index.php/s/RSJ05Nb9FTViCVK

This code is free for anyone to use. If you use it in a publication, please cite the Zenodo doi. 

 

Brian Metscher, Jan. 2024

 

 

** Real progress toward a Python solution can be found here: https://pypi.org/project/xrmreader/

It's based on the dxchange Python code, which seems to cover the reading of the xrm container files much better than the Java parser:  https://github.com/data-exchange/dxchange

** Note that Xradia .txm files can also be opened directly in Amira 6.4 and higher (Windows), and also in Drishti (https://github.com/nci/drishti). (Also in ORS Dragonfly Pro, but not in the free Dragonfly version.)

TXM-Wizard by fmeirerliuyijin can open Xradia files also:  

     https://sourceforge.net/projects/txm-wizard/files/?source=navbar

     https://www.ncbi.nlm.nih.gov/pmc/articles/PMC3284347/ 

 



Wednesday 4 May 2022

MicroXCT end of support

Please enter any points for discussion, questions, whinges, etc. as comments here. 

This forum will remain active for continuing use by the MicroXCT community. 

Our first Zoom meeting:

Topic: MicroXCT support group
Time: May 6, 2022 04:00 PM Vienna

Email me ( brian.metscher [at] univie.ac.at ) or Lidija Korat ( lidija.korat [at] zag.si ) for the meeting invitation. 


Tuesday 10 August 2021

Repositories for 3D image (and other) data

 

Registry of Research Data Repositories

http://re3data.org/

Listing of many repositories in all subject areas.

FAIRsharing

https://fairsharing.org/

"A curated, informative and educational resource on data and metadata standards, inter-related to databases and data policies." Lists lots of repositories, standards, and knowledgebases.

Zenodo

https://zenodo.org/

Hosted by CERN. "All fields of research. All types of research artifacts." Open data for open science. Up to 50GB per record, or by arrangement.

BioImage Archive

https://www.ebi.ac.uk/bioimage-archive

A free, publicly available online resource for biological images that are either associated with a peer-reviewed publication, or of value beyond a single experiment.

Figshare     https://figshare.com/

Choice of CC license.

Giga Data Base (GigaDB)   http://gigadb.org/

Uses CC0 (public domain) licensing.

iDigBio

https://www.idigbio.org/

The National Resource for Advancing Digitization of Biodiversity Collections (ADBC) funded by NSF. Data and images for millions of biological specimens.

MorphoSource

http://morphosource.org/

Duke Univ. Especially for museum specimens.

(Boyer et al 2017)

Brain Image Library  

https://www.brainimagelibrary.org/

"... national public resource enabling researchers to deposit, analyze, mine, share and interact with large brain image datasets."

Morph·D·Base   https://www.morphdbase.de/

Morphological Description Data Base. Not easy to access.

MorphoBank    http://www.morphobank.org/

"Homology of phenotypes & a database of peer-reviewed morphological matrices"

Digital Fish Library (DFL)

http://www.digitalfishlibrary.org/

Fish.

Digital Morphology (Digimorph)

http://digimorph.org/

Univ. Texas microCT library. Lots of fossils and other vertebrate samples, stacks, movies and more.

Dryad      http://datadryad.org/

Uses CC0 (public domain) licensing.

Phenome10k        http://phenome10k.org/

CT and surface scans of biological and palaeontological specimens (skulls).

Harvard Dataverse

https://dataverse.harvard.edu/

All kinds of data. Set up your own dataverse collection, up to 1TB. 

MorphoMuseuM (M3)

https://morphomuseum.com/

Mainly surface models. A peer reviewed, online journal that publishes 3D models of vertebrates, anatomy atlases, and 3D datasets. Also direct submission.

Aves 3D      http://aves3d.org/

Bird bones and skeletons

heidICON

https://heidicon.ub.uni-heidelberg.de/search

Image and multimedia database. Die Heidelberger Bilddatenbank, is the "Virtual Slide Collection" in progress of Heidelberg University.

Sammlungen Göttingen

https://sammlungen.uni-goettingen.de/  

Wissenschaftliche Sammlungen der Georg-August-Universität Göttingen.

Image Data Resource (IDR)

https://idr.openmicroscopy.org/about/

A public repository of reference image datasets from published scientific studies. (Williams et al 2017)

Phaidra (UniVie)

https://phaidra.univie.ac.at/

Phaidra is the repository for the permanent secure storage of digital assets at the University of Vienna.

GitHub       https://github.com/

The place for open software

New Mexico Decedent Image Database (NMDID)
https://nmdid.unm.edu/welcome  

provides researchers with access to whole human body computed tomography (CT) scans and a rich body of associated metadata.

FaceBase
https://www.facebase.org/  

Comprehensive craniofacial data (including 3D imaging datasets) from model organisms (mouse and zebrafish) and humans.

MorphoBrowser
http://morphobrowser.biocenter.helsinki.fi/  

‘MorphoBrowser’ database and interface is a 3D visualisation and searching tool for mammalian teeth, accessible over the web.

Phenome10K
http://phenome10k.org/  

A free online repository for 3-D scans of biological and palaeontological specimens.

Genetics of craniofacial shape in Mus
https://osf.io/w4wvg/  

High-resolution 3D microCT head scans of a mouse panel between C57BL/6J and A/J mouse strains and associated genotype data. Contains mCT scans of ~500 mice heads and associated cranial landmarks.

Digital Morphology Museum of Kyoto University (KUPRI)
http://dmm4.pri.kyoto-u.ac.jp/dmm/WebGallery/index.html  

DMM provides a large collection of CT and MRI tomography scans of various primates.

The Open Research Scan Archive
https://www.penn.museum/sites/orsa/Overview.html  

(formerly Penn Cranial CT Database) contains high resolution (sub-millimeter) scans of human and non-human crania from the Penn University Museum and other institutions.

GB3D
http://www.3d-fossils.ac.uk/search.cfm  

Fossils Online project, aims to develop a single database of the type specimens, held in British collections, of macrofossil species and subspecies found in the UK, including links to photographs and a selection of 3D digital models.

 

Other sources for 3D images:

The Visible Human Project

https://www.nlm.nih.gov/research/visible/visible_human.html

Full-body images of a male and female adult

Thingiverse

https://www.thingiverse.com/

Loads of cool 3D models for 3D printing

Phaidra (UniVie)

https://phaidra.univie.ac.at/

Phaidra is the repository for the permanent secure storage of digital assets at the University of Vienna.

 

A lot of these repositories and many others for various kinds of data and documents are listed at PUBLISSO (itself a repository): 
https://www.publisso.de/en/research-data-management/publishing/publisso-repository-finder/

Also good to know is DataCitehttps://datacite.org/ 


Monday 29 April 2019

Free 3D software

Our group has used Amira for a while, even though it is expensive and can take some effort to learn. I thought it would be of interest to know about some free alternatives for image processing, segmentation, and analysis. As far as I know, no single free package does everything that Amira does, and there is always a learning curve for a new package, but some are actually better than Amira for their respective purposes.  


All of the following are free. There are others of course, but the ones listed here have come to the top of my list. I will update this page as I learn more.


Fiji (is just ImageJ) https://fiji.sc/

Your best friend for general image manipulation (e.g. cropping, adjusting, and orienting image stacks), editing, and basic analysis. Many many plugins to do almost anything, some quite sophisticated. Open-source, easy multi-language scripting.

 

Dragonfly https://www.theobjects.com/dragonfly

Free for non-commercial research (license on request). Well-documented and extensively used. Easy to get started with video tutorials. Windows & Linux only.

Many of the manual segmentation tools also work directly in the 3D view. Includes a convolutional neural networks Deep Learning solution (www.theobjects.com/dragonfly/deep-learning) that lets users paint material phases of very complicated and low contrast materials and the software learns how to segment the rest of the image or similar datasets.


Drishti https://github.com/nci/drishti

Can make amazing visualizations, including key-frames-based animations. Powerful segmentation editor (DrishtiPaint). Steep initial learning curve, but the online tutorials are helpful. Drishti Prayog (https://github.com/nci/drishti#drishti-prayog ) makes spectacular interactive touch-screen presentations.


3D Slicer https://www.slicer.org/

An "open source software platform for medical image informatics, image processing, and three-dimensional visualization...built over two decades through support from the National Institutes of Health and a worldwide developer community.” Well-developed and widely used, with extensive documentation and training tutorials. Reasonably easy to get started.


Tomviz https://tomviz.org/

A "cross platform, open source application for the processing, visualization, and analysis of 3D tomographic data. Here the full pipeline of data processing steps from reconstruction to visualization to analysis of 3D data can be presented, saved, and restored." https://tomviz.readthedocs.io/en/latest/visualization/


ITK-SNAP http://www.itksnap.org/pmwiki/pmwiki.php

Designed for 3D image segmentation, "emphasizes interaction and ease of use, with the bulk of the development effort dedicated to the user interface."


Microscopy Image Browser http://mib.helsinki.fi/index.html

A "high-performance Matlab-based software package for advanced image processing, segmentation and visualization of multi-dimensional (2D-4D) light and electron microscopy datasets."


ImageVis3D is a new volume rendering program developed by the NIH/NIGMS Center for Integrative Biomedical Computing (CIBC). The main design goals of ImageVis3D are: simplicity, scalability, and interactivity.

https://www.sci.utah.edu/software/imagevis3d.html


Seg3D is a volume segmentation and processing tool developed by the NIH Center for Integrative Biomedical Computing. It combines a flexible manual segmentation interface with powerful higher-dimensional image processing and segmentation algorithms from the Insight Toolkit.

It has a strong emphasis on manual and semi-manual segmentation, where filtered data guides the user in making decent segmentations of the data. The program is mainly intended for, but is not strictly limited to, segmentation of biological/medical data. BioMesh3D (part of SCIRun) can be used to turn segmentations into quality meshes which can be used to simulate biological processes on the segmented images.

https://www.sci.utah.edu/cibc-software/seg3d.html


VolViewer

http://cmpdartsvr3.cmp.uea.ac.uk/wiki/BanghamLab/index.php/VolViewer

Easy to use, key-frames-based animation. No longer actively developed but still useful.


ilastik https://www.ilastik.org/

"ilastik is a simple, user-friendly tool for interactive image classification, segmentation and analysis.... has workflows for automated (supervised) pixel- and object-level classification, automated and semi-automated object tracking, semi-automated segmentation and object counting without detection."


CDeep3M is a containerized tool, using deep learning for large-scale image segmentation tasks. It is an open source development and the software is free to use. You can run CDeep3M on your local platforms, on cloud providers, on GPU clusters or with free GPU resources on this website.

https://cdeep3m.crbs.ucsd.edu/cdeep3m


MeVisLab https://www.mevislab.de/


MeshLab http://www.meshlab.net

Famous freeware for working with surfaces. 



The site https://www.idoimaging.com/ has loads of imaging software listings


The Scientific Community Image Forum at https://forum.image.sc/ is a discussion site for software-oriented aspects of scientific imaging, particularly (but not limited to) image analysis, processing, acquisition, storage, and management of digital scientific images.



Blog post on Free software for CT segmentation (2019)

https://peterfalkingham.com/2019/02/18/free-software-for-ct-segmentation-2019


For setting landmarks in 3D images:

(From ResearchGate, 6 years ago) 

Luisa F Pallares

Hi Stefan. The best software for doing that is called TINA Landmarking Tool. It is pretty cool 'cause for placing landmarks you use the cross-sections of the structure (though you can also use the 3D volume) and therefore you can place landmarks in literally every place (internal or external). Besides that, it gives you the possibility of extreme accuracy. I work with mouse skulls and use that software for placing my 3D landmarks. You can get the package and the manual from Anja Schunke in the Max Plank Institute for Evolutionary Biology: schunke@evolbio.mpg.de


 

Sunday 31 March 2019

PTA colour change, agarose and destaining

On 18/03/2019 21:38, Gonzalez, Brett wrote:
Hi Sarah…

My name is Brett Gonzalez and I am a postdoc at the Smithsonian National Museum of Natural History, previously a Ph.D. student with Katrine Worsaae. I am not sure if you remember, but last year I emailed you regarding some general advices towards integrating CT work into my research. Here at the museum we have a newly installed GE nanoCT and since the technicians are still technically new, I am hoping you could potentially assist once again with my questions.

I work on scale worms and since they soft bodied and fragile, I wanted to integrate alternative methods for scanning aside from just placing drying them or leaving in ethanol or other liquid. Several papers, including some where you have worked on, have used low-melting agarose to imbed the animals prior to scanning. The agarose percentages I have seen range from 0.5%-1.5% with very few other specifics. I have now tried twice, the most recent being with a 0.5% agarose embedded animal, and the entire pre-scan viewing is opaque or nearly. The animal cannot be seen. Can you think of anything in the embedding process that I am doing wrong that would prevent the X-rays from penetrating the agarose and the specimen? The agarose is prepared in 1% TAE buffer mixed with di-water. 

My only thoughts are that when putting the specimen in the agarose, the warm temperatures are causing the PTA to come out of the animal and disperse among the agarose. Could this be the case or is the agarose maybe wrong brand or age or something else? I would really like to use agarose so that specimens without chaetae don’t move during the long scans.

The only other question I have is that I had a specimen turn from ivory color (in ethanol) to blue/brown after a scan, but only in the portion being scanned. The specimen eventually turned back to the original ivory color upon upon placing in new ethanol. Have you seen this before and is this somewhat normal in liquid mounted specimens or is it an energy issue when running the scan? I have not been able to see any literature or mention of this either.

Sorry for such random questions but would really like to keep going with this technique in order to investigate muscular innervations in swimming scale worms and other annelids. Any help on the issue is greatly appreciated.

Thank you for your time.

Cheers,

Brett

--
Brett C. Gonzalez, PhD.
Postdoctoral Fellow

Smithsonian Institution
National Museum of Natural History
Hi Sarah & Brett,

Random questions are sometimes the best ones. Starting with the colour change: I often see PTA-stained regions change to blue-green-brown under X-rays, then revert after some time to the original whitish. I have assumed that this is caused by an oxidative change in the tungsten. I have not seen any effect on the scan quality. 

PTA can leach out into the agarose (where it can also turn green), but usually does not if the sample has been rinsed after staining. PTA binds strongly to proteins under acidic conditions, and this seems to be permanent if the pH stay low. PTA staining can be removed with a slightly alkaline buffer, or even with PBS, as the PTA polyacid molecule dissociates into smaller tungstate species at higher pH. 

Which brings us to the agarose: I always use agarose in water (usually 0.5%-1.0%), unless I want to keep the tissues in a buffer for some reason. I have seen PTA staining fade in agarose in PBS; iodine staining is OK. I use low-melting temperature agarose, so that it can cool to below 37°C before immersing the specimen (it gels around 33-35°). 

So I imagine the problem is the TAE, which has a pH of 8 or so as I recall, plus a chelating agent (EDTA). My guess is that your agarose effectively dissociated and dispersed the PTA more or less uniformly. Aqueous agarose might solve the problem. 

Another fun trick for embedding fragile samples is to use CyGel, a thermoreversible gel which solidifies at room temperature and melts in the fridge. This avoids the problem of removing agarose from delicate specimens: just wash in cold buffer or ethanol. However, it's really expensive. (http://www.biostatus.com/CyGel/)  

Another way to remove agarose is to drop 6M potassium iodide over the specimen while brushing off the agarose as it dissolves (this helped with a centipede holotype - lots of breakable legs... Akkari et al. 2018) 

Hope this helps. With your permission, I will also post you message and this reply to my blog (http://microtomography.blogspot.com/). 

Best,
Brian 

Akkari N, Ganske A-S, Komerički A, Metscher B. (2018). New avatars for Myriapods: Complete 3D morphology of type specimens transcends conventional species description (Myriapoda, Chilopoda). PLoS ONE 13(7): e0200158. 
https://doi.org/10.1371/journal.pone.0200158

Monday 22 October 2018

Destaining: PTA

Actually, PTA staining can (mostly) be removed after scanning. I had a student (Hannah Schmidbaur) do some studies on this, and I have done some more experiments. The short answer is to wash out the PTA with a slightly alkaline buffer, e.g. PBS with 0.01M NaOH (figure below; third row). The destaining takes about as long as the staining did (I think), and you should make sure there is enough destaining buffer (at least 10X the volume of the tissue). And of course the only way you can see if the PTA is gone is using X-ray imaging.

Hannah's presentation from the Bruker MicroCT user meeting 2015:
https://www.bruker.com/fileadmin/user_upload/8-PDF-Docs/PreclinicalImaging/microCT/2015/uCT2015-21.pdf