== THIS PAGE HAS BEEN MOVED TO SHAREPOINT! ==
Please refer to this site/make edits here for the most updated information: https://partnershealthcare.sharepoint.com/sites/LCN-Exvivo/SitePages/3D-Scanning.aspx
----
<
>
<
>
<
>
= Structure 3D Scanner Wiki =
'''Index''' <>
== Setting Up For the First Time ==
=== Skanect: ===
This is the software needed to stream and process the images captured by the Structure 3D Scanner (via iPad). You can download Skanect on your Mac laptop from this website: [[https://skanect.occipital.com/download/#purchase|Skanect]].
1. Under the $0 column, click on the "Windows 64-bit" link
1. Follow downloading instructions
1. Log on to Skanect using the freesurferlab@gmail.com email and ask Allison, Leah, or Dev for password if you don’t have it
Open the Skanect application and it should look like this:
<
>{{attachment:Skanect_Desktop.png||height="500"}}
<
>
<
>
<
>
=== Structure by Occipital: ===
This is both the (attached) camera and the application on the iPad that captures images and streams them to Skanect on your laptop.
* Make sure the scanner is plugged into the iPad via the white cord.
*The Structure app is already downloaded on the iPad and it should display the 3 settings for image capture
* IR, Depth, Depth + Color
<
>{{attachment:structure_desktop.png||height="400"}}
== Streaming from Structure Scanner (iPad) to Skanect ==
In order to stream, you must first set up an Ad Hoc connection between the iPad and your computer. '''''You will have to do the latter portion of these steps before each scan session!'''''
=== Part 1: On your laptop/Mac ===
1. Open System Preferences
1. Open Network
1. Select "Show Wi-Fi status in menu bar"
1. Click on "Advanced"
1. Select "Create computer-to-computer networks"
1. Select "OK"
1. Press "Apply"
1. Close System Preferences
1. Click on Wi-Fi symbol at the top right hand corner of your desktop
1. Select option Create Network
1. Enter a new name, for example "UplinkNetwork"
1. Make sure the Status is On
1. Open up Skanect application
=== Part 2: On the iPad ===
1. Tap on the Settings icon in your iPad main menu
1. Click on Wi-Fi
1. Your ad hoc network "UplinkNetwork" should appear in the list.
1. Click on your network.
1. Select "Join Anyway"
1. Making sure that the Skanect application is open on your laptop, open up Structure and you should now see the streaming option "Uplink" appear:
<
>{{attachment:uplink_appears.PNG||height="500"}}
Scroll down so that you are on the "Uplink" tab, it should display whatever you're pointing the iPad at (in this case, the iPad was face down, so the screen is black)
<
>{{attachment:uplink.PNG||height="400"}}
<
>
<
>
Now, go over to Skanect on your laptop and it should look like this.
<
>{{attachment:uplink_successful.png||height="500"}}
<
>
You are now ready to scan!
<
>
== Getting Started ==
=== Set-up Streaming ===
'''On your laptop'''
1. Click on Wi-Fi symbol at the top right hand corner of your desktop
2. Select option Create Network
3. Enter a new name, for example "UplinkNetwork"
4. Open up Skanect software
'''On the iPad'''
1. Open System Preferences > Wifi
2. Select "UplinkNetwork"
3. Open up Structure app
4. Scroll to Uplink
== Set-up Scanning ==
=== Calibration ===
Separate app already on the iPad; worth doing before each scan, if you don't have a standard scanning location/set-up
* Open up app before starting scan session
* More blue dots means better calibration; Blue dots represent unique features from contrasted color values which are often sharp angles or corners.
* The software searches areas in the camera image looking for distinct angles created by the background of the object against the color of the contrasting forefront object
* Move around slowly, pausing on bright complex scenes
* For higher detail scans, “zoom”, refine FOV, and save calibration
* Once calibration is saved, open up Structure app
=== Brain Set-up ===
White or black background??? -- Tutorials often show objects on white table
* Place the brain in a space in which you have 360 degree access
Stationary brain and camera moves around brain '''or''' stationary camera and brain rotated???
* Whichever you choose, the object moves relative to itself during the scan you’ll get some double images and rough seams in the scan
=== To Start Scanning ===
1. To start a new scan, open Skanect software. Under the '''''Prepare''''' tab, select "New" and adjust the following settings:
* '''Scene''' to "object"
* '''Bounding Box''' to
* '''Aspect Ratio''' to
* '''Path''' to wherever you would like your scans and files saved to.
<
>'''BOUNDING BOX is Everything'''
<
>Before you begin recording your scan (Under the '''''Record''''' tab), be sure that the brain fits snugly within the bounding box tight.
* Tight enough to where the scanner does not waste time scanning items in the background, but not too tight so that you have 'wiggle room' to move around as you try to capture all angles of the object during scan session
* To adjust Bounding Box:
* Use the 3 mouse buttons to orbit, pan, and zoom your view in '''''Record''''' tab
* Adjust size of Bounding Box in '''''Prepare''''' tab
* The object needs to be in this position when the scan starts, after that you can start to move around the object
=== Scanning Tips ===
* Can not detect closer than 40 cm; keep distance from brain
* Scan more than you need, because edges can be rough.
* Make sure you get high and low angles all the way around; especially the top
* If you move too fast or don’t have enough of the object in the frame, you’ll lose tracking; if you can’t move back to the exact same position and angle, stop the scan, click the trash can to delete what you recorded and start again
* While you're scanning you'll notice ### '''FPS''': _________
* Press stop when you’ve turned the whole object green – your computer will process the scanned images and depth data and will construct a final mesh
=== Post-processing ===
You can try using the built in processing tools, but more detail and better results by exporting the raw scan and cleaning in Meshmixer???