OTN Workshop 2014 OTN SandBox Presented by Marta Mihoff OTN Database/Data Process Manager
Start Oracle Virtual Box and OTN SandBox Open Start Window Click on Oracle VM VirtualBox Start OTN Sandbox
Outline Background Platform Overview Exercises Upload new Sandbox Backup data folder and Upload data files Create working folder File Conversion White-Mihoff False Filtering Tool Distance Matrix Merge Mihoff Interval Data Tool Cleanup Tool Wrap Up
OTN Sandbox Backround Symposium 2013 researcher requests Fall 2013 request from Steve Kessel and Eddie Halfyard Reverse engineered Easton White’s code Presentation Platform Winter development and testing
OTN SandBox Platform Free open software Black Box Oracle Virtual Box OTN Sandbox Appliance Postgresql 9.1 database PGAdmin Python 2.7 Rstudio (only part visible)
OTN SandBox Tools White-Mihoff False Filtering Tool Builds a file of suspect detections Creates a file of filtered detections Creates a distance matrix Distance Matrix Merge Outputs a matrix overriding distances with researcher input Mihoff Interval Data Tool Creates a file of Compressed detections and a file of interval data Miscellaneous File Conversion (UTF8) Cleanup
Start Oracle Virtual Box and OTN SandBox Open Start Window Click on Oracle VM VirtualBox Start OTN Sandbox
Sign In Open Chrome or Firefox Paste sandbox URL Sign in Username: sandbox Password: otn123 Will not work with VPN turned on
Exercise: Update Sandbox Folder Navigate to Documentation folder on USB stick Open Update Sandbox Tools Instructions.doc Move files you want to Save
Update Sandbox: save off files Click New Folder button Type in a folder name Click OK Confirmed you have saved files
Exercise: Update Sandbox Folder Navigate to folder Rstudio Check the sandbox folder Delete folder sandbox Click the Upload button
Upload Sandbox Folder Navigate to USB stick OTN TOOL BOX/OTN Sandbox Choose sandbox.zip Click Open Click OK
Data Folder Management Manage your own data Keep separate data folders for different projects Current working data folder is always “data” You can export a folder to your desktop
Exercise: Renaming data folder Check the data folder Click the rename button on the Files menu Type new name for data folder Click OK
Upload Sample Data Click the Upload button Navigate to USB stick Choose data.zip Click OK
Create a work shop folder for test scripts Click New Folder button on Files Menu Type in folder name Click OK
Documentation and Software Location Introduction page with links Direct Location for most up to date version
Folder Structure: Software Check the date of sandbox.zip Upload if more recent than your version Watch for ova updates. OVA replacment would be required if the underlying platform needed to change.
Folder Structure: Documentation There is extra stuff for geeks in the Appendix of the Install guide Update Sandbox Tools Instructions would be used after initial install to add new functions or fixes Troubleshooting will be expanded as users report problems and we find solutions
Exercise: File Conversion Open sandbox folder Click on file_conversion_driver.r File will open in upper left window of GUI Save file to WorkShop Scripts folder
Exercise: File conversion Open data folder Cut and paste the file name into the script Save the script
Running R-scripts Highlight the lines you want to execute Click the run button
File Conversion: NotePad++ Encoding Open file in NotePad++ Click Encoding on Menu Bar Button indicates encoding Click Convert to UTF-8 wo BOM Save file
Exercise: filtering suspect detections Open sandbox folder Click on filter_driver.r Will open in upper left window Save to WorkShop Scripts folder
Exercise: Filtering Control Parameters Highlight this entire section and click the run button
Exercise: Filtering Functions loadDetections() Input a detection file Outputs a file of suspected detections And an optional distance matrix filterDetections() Input a detection file and a file of suspect detections Outputs a file of filtered detections And an optional distance matrix
False Filtering: Minimum Requirements Column: unqdetecid must be present. Must contain unique values. Column: catalognumber must be present. This can be an animal id or a transmitter id. Column: datecollected must be present. Must be format YYYY-MM-DD HH:MI:SS or YYYY-MM-DDTHH:MI:SS All digits must be present Column: station must be present.
False Filtering: Set input values Open data folder Highlight input detection file and copy Paste into script window over detections.csv
Run the load step Paste the file name between the quotes Highlight this section of code Click the run button
Output Messages: Load Step
Data: Suspect Detections ( transposed ) Each row represents info about three consecutive detections of one animal The column value for suspect_detection represents the unique id from the input file
Run the Filter Step If you have your own file of suspect detections or have edited the one the tool created This is where you override the input file Otherwise the program will use the one created in the previous step
Output Messages: Filter Step Messages will tell you: What file of suspect detections was used What the input detection file was Record counts Output file names
Data: Distance Matrix
Exercise: Distance Matrix Merge Open sandbox folder Click on distance_matrix_merge_driver.r Will open in upper left window Save to WorkShop Scripts folder
Exercise: Distance Matrix Merge File for distance_matrix_input was created in false filtering step Highlight file sample_distance_matrix_override_values.csv in the data folder and paste into distance_real_input expected value
Exercise: Distance Matrix Merge Highlight entire script Click Run
Exercise: Interval Data Open sandbox folder Click file interval_data_driver.r Will open in upper left window Save to WorkShop Scripts folder
Exercise: Interval Data Grabbing filenames for subsequent steps Find them in the output in the output Console. Bottom L.H.S.
Exercise: Interval Data Grab the output file of detections from the last step of the filter step Grab the output file from the distance matrix merge step Paste values into the script Save the script
Exercise: Interval Data Execute the script
Data: Compressed Detections
Data: Interval Data
Exercise: Cleanup Open sandbox folder Click on file cleanup_driver.r Will open in upper left window Highlight entire script Click Run
Teach yourself to program Free open software Extremely powerful Standardized Python Python(x,y): rival to MATLAB and Rstudio PostgreSQL
How? Coursera Rice University : An Introduction to Interactive Programming in Python TBA University of Michigan : Programming for Everybody Next Session Jun 2 Johns Hopkins : R Programming Part of the "Data Science" Specialization Next session Jun 2 ( not too late)"Data Science" Specialization
PostgreSQL: Online Tutorials /
RStudio vs R Prefer Rstudio User friendly Interface Not standardized so use with caution Null always TRUE Unpredictable results Help Rseek:
Questions? Wish list? Cohort data Separate files for animal detections on other lines Station Group mapping function If you can think it and describe it in English, we can program it.