Transcript Customizing the NOAA

Customizing the NOAA
SOS Public Kiosk
Keith Searight
Senior/Lead Software Engineer for SOS
2015 Science On a Sphere ®
Users Collaborative Network Workshop
December 2-4, 2015
NOAA SOS Public Kiosk
•
•
•
•
Widely requested
General public users
Touch screen controls
Standard hardware
SOS Users Collaborative Network Workshop
• Trackball style sphere motion
• Multi-language support
• Easy and flexible configuration
Dec. 2-4, 2015
2
Basic Information
How to get it?

E-mail us at: [email protected] to get a download link
What does it cost?

Free to SOS sites
What hardware is needed?


All-in-1 touch screen PC or separate PC and touch screen monitor
Kiosk mounting hardware
What software is needed?


Windows 7 or 8 (WinXP & Win10 may work)
Free FTP client software (optional)
What support is offered?


NOAA Kiosk manual: sos.noaa.gov/Support/noaa-sos-public-kiosk.html
Same free support as other SOS software
SOS Users Collaborative Network Workshop
Dec. 2-4, 2015
3
Software and Utilities Used
• Kiosk Machine (Windows)
• NOAA Kiosk Software
•
•
Public User Interface
Administration User Interface
• Notepad (text editor)
• FTP Client – optional (e.g., FileZilla or FireFTP)
• SOS Machine (Ubuntu)
• SOS (Automation Command Protocol)
• media2kiosk (command line utility)
• FTP Server – optional (vsftpd)
SOS Users Collaborative Network Workshop
Dec. 2-4, 2015
4
Public User Interface
Using the Kiosk:
1. Select a Group
2. Select a Dataset
3. View Information
4. Control SOS
5. Select Overlays
6. Repeat Steps 1-5
Other options:
1. Kiosk Info
2. Change Language
SOS Users Collaborative Network Workshop
Dec. 2-4, 2015
5
Installation and Initial Setup
1.
Install the kiosk software
•
•
download NOAA_SOS_Kiosk_5.0-Setup.exe from link on sos.noaa.gov
run setup and follow the instructions
2. Run the Kiosk from the desktop icon
3. Click on Administration Button & enter default password: 1234
4. Edit Properties
•
•
kiosk_server: 127.0.0.1 → SOS machine IP or name
password: 1234 → something harder to guess
5. Apply, then Function > Exit Application
6. Verify the kiosk interacts with your SOS
SOS Users Collaborative Network Workshop
Dec. 2-4, 2015
6
Data and Configuration Files
• Kiosk Machine (Windows)
• Directories under c:\shared\sos\kiosk
•
•
•
•
config: settings.txt, logo image, localized text
resource: buttom images
datasets (auto generated): button & sphere images, localized text
groups (auto generated): button image, localized text
• SOS Machine (Ubuntu)
• Dataset Playlists & Media (images/movies, thumbnails, data catalog)
• Directories under /shared/sos/kiosk
•
•
images: group images
playlists: kiosk, groups, group datasets, localized datasets & group text
SOS Users Collaborative Network Workshop
Dec. 2-4, 2015
7
Using the Admin UI
• SOS Settings
•
•
•
•
Viewpoint Correction (Configuration tab): Ready → Rotate → Set
autoplay: 0 (off), 1 (within group), or 2 (random)
duration: dataset play time (autoplay on)
timeout: autoplay resume time (autoplay on)
• Colors and Fonts
•
•
•
Title Area: banner_background, banner_fontcolor
Main UI: background, fontcolor
Information Box: content_fontsize
• Buttons
•
•
Datasets and Overlays: circlecolor, nowcolor (current selection)
Groups: nowcolor (current selection)
• Language Options
•
•
locale_default: xx_YY (ISO Locale: xx = language, YY = country; en_US is the default)
locale_options: comma separated locale list (e.g., “en_US,zh_TW,es_MX”)
SOS Users Collaborative Network Workshop
Dec. 2-4, 2015
8
Customizing UI Text
• UI text files
•
•
•
•
Not autogenerated on SOS machine
Uses locale naming: xx_YY.txt (ISO Locale: xx = language, YY = country; en_US is the default)
Propery file format: name = value lines (plus comments)
Notepad.exe can edit
• Minimum requirements
•
config\en_US.txt: title, subtitle, dataset, overlays
•
config\info\en_US.txt: freeform text about SOS and how to use the kiosk
• Add translated versions for locales in locale_options property
•
xx_YY.txt files under config and config\info
• Anything missing defaults back to en_US version
SOS Users Collaborative Network Workshop
Dec. 2-4, 2015
9
Configuring Groups and Datasets
• Playlists on SOS machine define Group Column, Overlay Column, and
Dataset Rows
• kiosk.sos: master playlist for the kiosk
•
include = lines for each group playlist in order (top-to-bottom)
• Group playlists
•
•
•
include = lines for each dataset in order (left-to-right)
icons = path to button image (non-standard use of this keyword)
playlist name is default group label (e.g., air.sos for “air” group)
• Datasets: default name & description from SOS Data Catalog
SOS Users Collaborative Network Workshop
Dec. 2-4, 2015
10
Customizing Dataset and Group Text
• Customize and localize using playlists
•
•
•
Use to autogenerate datasets and groups files on SOS machine
Uses locale naming: xx_YY.sos (ISO Locale: xx = language, YY = country; en_US is the default)
Files go in playlists/locale/dataset and playlist/locale/groups
• Groups
•
•
Files go in playlist/locale/groups
Use include = and rename = lines for each group
• Datasets
•
•
Files go in playlists/locale/dataset
Use include =, rename =, and description = lines for each group
• Default kiosk installation
•
•
en_US for all groups and datasets
zh_TW for all groups and some datasets
SOS Users Collaborative Network Workshop
Dec. 2-4, 2015
11
Setting Groups and Datasets on the Kiosk
• Run media2kiosk command line utility on SOS machine
•
•
Reads playlists and generates the groups and datasets file hierarchy
Do not edit the generated files! Modify the playlists and rerun media2kiosk.
• Must transfer groups and datasets files to the kiosk machine
• Two options:
•
“Sneaker net”: use a flash drive to copy files
•
Use FTP (instructions in NOAA SOS Public Kiosk manual)
•
SOS machine: vsftpd (free FTP server)
•
Windows: free client (e.g., FileZilla or FireFTP)
SOS Users Collaborative Network Workshop
Dec. 2-4, 2015
12
Questions?
SOS Users Collaborative Network Workshop
Dec. 2-4, 2015
13