From Headus Docs

Contents 1 Wish/Bug List 2 Software Overview 3 CySize Installation 4 CySize Measurement Codes 5 Upload folder for Windows 2000/XP 6 Named Volumes 7 Raspberry Pi HLServer 7.1 Setting IP Address 7.2 Configuring HLServer 7.3 Running HLServer

[edit] Wish/Bug List

- "being able to save our work (landmarks, the reflected geometry)? so that if i ever want to recalculate with a different error or add a few measurements, i dont have to start all over again and mark out everything again?"

- "We'd like to use the bony landmarks and match them as best as possible and then do the surface operations from that, We think it'd be a good reproducible operation and be a bit more sensitive to differences in symmetry."

[edit] Software Overview

CyScan 

Run by double clicking the CyScan desktop icon. Used to drive the WBX scanner, and its the front-end for scan merging. Loads IV files. License is tied to the scanner PC.

PlyEdit 

Called by CyScan's Merge routine, and it merges the four overlapping scan files into a single surface. Creates PLY files. License is tied to the scanner PC.

AutoFill 

Called by PlyEdit's Body AutoFill routine, and its used to fill all the holes, with arm segments placed to stop the auto-fill from joining the arms to the torsu, and a crotch segment placed to stop the legs being joined at the top. License is tied to the scanner PC.

CySize 

Run by dragging merged a PLY file onto the "headus CySlice" desktop icon. Its used to extract measurements from the filled scans. License is tied to the dongle, so can be run from any configured PC.

[edit] CySize Installation

1. Open up your clients page.
2. Download and run the latest (closest to top of list) icyslice-*.exe file to install CySlice.
3. Download and run the HDD-Win-*.exe file to install the dongle driver.
4. Double click the headus CySlice desktop icon to run the Licensing GUI. You should see 2d7a1ec1 next to the Dongle label when the dongle is attached.
5. Click on the Edit button, and cut and paste the line of hex number under Current Keys on your clients page into the Notepad window.
6. Save the keys file, then click on the Refresh button in the Licensing GUI. You should then see permanent next to CySlice.

[edit] CySize Measurement Codes

Magenta Curves

 C = Point to point caliper measurement.
 S = Over surface length
 T = Convex hull tape measure length

White Sections

 A = Cross-sectional area
 S = Over surface girth
 T = Convex hull tape measure girth

Red Volumes

 V = Volume
 A = Surface area; doesn't include fill

[edit] Upload folder for Windows 2000/XP

These instructions apply to Windows XP, but the process in Windows 2000 is similar.

1. Open the 'My Network Places' folder. If you don't know where this is, go to 'Start -> Help' and search for 'add network place', then look for a 'My Network Places' link in the help documentation.
2. Once you have the 'My Network Places' folder open, double click 'Add a network place.'
3. When asked where you want to create the network place, select 'Choose another network location'
4. In the 'Type the location of the Network Place' text box, enter in http://www.headus.com:80/au/clients/fmc/upload
5. Enter fmc for the User name, and lynton for the Password
6. In the 'Enter a name for this Network Place' text box, enter "headus Upload".
7. To complete the setup, click Finish. A Microsoft Web Folder appears showing the contents of the upload folder.

To upload files, just drag'n'drop them into this folder.

You may see two files in this directory - .htaccess and .htpasswd - when you connect to it. These files do need to be there and you won't be able to delete them, so they can safely be ignored.

[edit] Named Volumes

Use this work-flow to name your volume measurements. See Fig 1 for a graphical representation of these steps.

1. Tick the Name option in the object visibility panel. You do this so you can see the name labels once they have been assigned to the volumes.
2. Click on the gray Names button towards the bottom of the main GUI window. This pops up a new window that is used to manage names lists.
3. Click on the Load List button, then select the names TXT file that you want to load.
4. After the names are loaded, the top list shows the names not yet assigned, and the bottom list are names that have been used.
5. To assign or re-assign a name to a volume, double click that name in either list, and then you should see LMB:pick-point towards the bottom of the 3D window.
6. Left mouse button click on a red volume seed point in the 3D window - it should turn yellow - then hit the <Space> key to assign that name.
7. Repeat until all names have been assigned.

---

A volume names TXT file might look like this:

VHead
VTorso
VBreastLeft
VBreastRight
VArmLeft
VArmRight
VLegs

You can give your volumes any name, as long at the first letter is a capital V.

---

Once you have named the volumes, you can export the values to a CSV file by clicking on the Export Points and Curves button in the main GUI window. Select an existing CSV file, or type in a new name, to add or update the measurements in that file. A single CSV file can hold the measurements for a number of different PLY files; each file will be recorded on a separate row in the exported table.

Exported volumes will appear as two values per cell; the first is the volume in microliters (divide by 1 million to get liters), and the second value is the surface area of the segmented volume in mm² (divide by 1 million to get m²).

[edit] Raspberry Pi HLServer

Note: When running the full screen desktop environment, the Raspberry Pi is slow by modern standards. If you double click a file or command, then expect to wait a few seconds for something to happen.

1. Plug in monitor, USB keyboard and mouse.
2. Connect power cable to Pi, but don't plug in to power just yet.
3. Turn on monitor.
4. Plug in Pi power.

The Raspberry Pi should then boot up, and after a minute or so you will see the login screen.

Username: HLServer
Password: headus3d

[edit] Setting IP Address

After logging in, go to ...

Applications Menu -> Settings -> Network Connections

1. Select "System eth0" and click "Edit" (see Fig 2).
2. Open the "IPv4 Settings" tab.
3. Edit the "Address", "Gateway" and "DNS servers" IP addresses to suit your LAN.
4. Click "Save..." to save the settings.

[edit] Configuring HLServer

1. Double click "File System" on the desktop to open up the File Manager.
2. Double click "usr" then "local" then "hlserver" to go to that directory.
3. Double click "hlserver.conf" to edit that file.
4. Change the "GROUP lan" to suit your LAN IP ranges (see Fig 3).
5. Save "hlserver.conf".

[edit] Running HLServer

1. Plug in the Ethernet network cable
2. Open a Terminal window (grey screen icon on bottom of desktop).
3. Run the "reboot" command.

The Raspberry Pi will then reboot and should be ready to serve licenses to the client applications. See Application Config in the HLServer User Guide for details on setting up the CySlice/CySize clients. Use the IP address of the Raspberry Pi in the Common Preferences "HLServer" field.

If you wish to monitor HLServer remotely, then read the The Manager chapter. You will need to add the list of trusted users to the "GROUP Manager" line of the "hlserver.conf" file. The best way to find the correct usernames is to try and access HLManager from the user workstation, then check the hlserver.log files for access denied errors. The usernames listed in the error messages can then be cut'n'pasted into the config file. After making any change to the config file, either run the HLManager "reload" command, or reboot the Pi if you dont have the HLManager access worked out yet.

Once you are happy everything is working OK, you can remove the mouse, keyboard and monitor. If you need to reboot the Pi in an emergency and dont have a mouse, keyboard and monitor handy, then you can 'ssh' in from another system on the network (login is HLServer) and run the 'reboot' command. If you dont have 'ssh', simply unplug the power and plug it back in again.