SuperScanner Software (S3)
SuperScanner Software (S3) is an free and open-source software environment used for implementing a low-cost scanner 3D, which can also function as a microscope and a 3D printer. S3 is the software portion of SuperScanner project. SuperScanner Software is licensed under GPLv2 license.
S3 is compatible with Microscopx, a project that enhances a low-cost microscope with this software.
The Framework (ES)
Note: These Jupyter modules has been tested in machinas that run the 64-bit version of KDE neon User Edition 5.12 based on the latest Ubuntu 16.04 LTS.
- Git. Install it from command-line with
$ sudo apt-get install git. After installing, execute:
$ cd ~ $ git clone https://github.com/josemarroquintoledo/superscanner-software-s3.git
- Anaconda Distribution: Python + «250+ popular data science packages». Please, install the version for Python 3, because S3 only works with Python 3.
OpenCV. We have tried with the 3.1.0 version and it works well (to 2018 March, 27th). After installing Anaconda Distribution, go to the command line and execute:
$ conda install opencv.
3D Scanning (simulated)
We suggest the following order:
Blender. It can be installed from the command-line with
$ sudo apt-get install blender.
Mesurelt (optional) by Antonioya is an add-on «for displaying measures [of meshes] in the vewport» in Blender. Download the ZIP file and install it in Blender from File → User Preferences... → Add-ons → Install from File...
py3exiv2: Allows to use the lib exiv2 with Python 3. exiv2 is a C++ library designed to handle the EXIF image metadata.
IPython for Blender by panzi to run Blender scripts in Jupyter notebooks. Before installing, make sure you installed the dependences. Anaconda Distribution does not resolve them:
$ sudo apt-get install python3-pip & sudo pip3 install --upgrade pip jupyter ipython notebook.
MeshLab. Install with:
$ sudo apt-get install meshlab.
Within the main folder:
blend-meshes: Folder for the printable parts and pieces of SuperScanner Hardware (S2H), the complete model of the machine manipulable in Blender and scenes that execute the Blender scripts.
examples: Folder with sample Jupyter notebooks to try, for example, the Fourier Ptychography imaging technique from a simulated or real image set.
img: Contains some pictures that are used by some notebooks.
jupyter-modules: Where the Python modules written as Jupyter notebooks are stored. For example, there are notebooks that are used by the Fourier Ptychography reconstruction algorithm and access to the data and functions of Blender outside of this and simulate the picture taking process for photogrammetry.
scripts: Contains Python scripts (.py), for example, to call the external software during the photogrammetry process and put the LEDs in the illuminator in the blend model of the machine (S2H).
Importing and Executing the Code
Blend scripts can be imported in Blender from Choose Screen layout→Scripting→Open. To execute them, press Run Script button and wait for the result.
Spring, K.; Komatsu H.; Scott, M.; Schwartz, S.; Fellers, T.; Carr, K.; Parry-Hill, M y Davidson, M. (2017). Microscopy Basics | MicroscopyU. Retrieved from https://www.microscopyu.com/microscopy-basics
UCLA Technology Development Group. (2017). Computational Out-Of-Focus Imaging Increases The Space-Bandwidth Product In Lens-Based Coherent Microscopy. Retrieved from https://techtransfer.universityofcalifornia.edu/NCD/28827.html
Zheng, G. (2016). Fourier Ptychographic Imaging: A MATLAB® tutorial. San Rafael, CA: Morgan & Claypool Publishers.