In this tutorial we will focus on a common use case: setting up a simulation of a fast runner in Simulation Construction Set using Eclipse IDE. We assume you are running Windows on a 64-bit platform. Always use 64-bit software.
1. Gaining Access To Crowd and Slack Support Channel
Email firstname.lastname@example.org or email@example.com to obtain credentials to IHMC repositories. Make a file in <user_home>/.gradle/gradle.properties and add the following two lines, with your Crowd credentials.
Support for this tutorial is provided in the IHMC Robotics #help-desk channel. Please email firstname.lastname@example.org or email@example.com for access after you have created an account: https://slack.com/get-started
2. Install the Java Development Kit (JDK)
Install version 8u131 or higher of the JDK (we do not yet support 9 as of May, 2018) - http://www.oracle.com/technetwork/java/javase/downloads/index.html
3. Install and Configure Eclipse
Use the installer to install "Eclipse IDE for Java Developers": https://www.eclipse.org/downloads/eclipse-packages/?show_instructions=TRUE#page-download
Close Eclipse. Navigate to where you installed Eclipse and find the file eclipse.ini. Modify the following lines in this file to allocate 2 GB of memory with a 6 GB maximum. This will drastically increase the performance of Eclipse.
4. Clone Fast Runner Repository
b. Click the clone button, select HTTPS, and copy the URL.
c. In Eclipse, type "git" into the Quick Access bar and select Git Repositories to open the view.
d. In the Git Repositories view, click the "Clone a Git repository" button. Information will fill in automatically. You can use the defaults except for the Local Destination, which you want to put in a folder called repository-group/fast-runner.
5. Import Hex Runner
In Quick Access, search "import", and select Import Existing Gradle Project. (Or use File->Import->Gradle→Existing Gradle Project)
Follow the default options but for Project root directory, select the "spoked-runner" folder where you cloned the fast-runner repository from above. Also, override workspace settings and select Specific Gradle version. Select Gradle 4.2 or Higher (4.7 as of May 1, 2018). Click Finish. It might take 10-20 minutes to import on slow computers or connections.
6. Running a Simulation
Press Ctrl-Shift-T and search for SpokedRunnerSimulation. Hit Enter. Right click in the file and select Run as > Java Application. Simulation Construction Set will load. Click the "simulate" button to run the simulation.
7. Next Steps
To fully configure Eclipse for development seeEclipse Development Setup
To clone more software and work on the code of SCS, see Intermediate Quick Start: Robot Lab Developers
To make a new project see Advanced: Creating a New Project or Repository
For info on how our developers work see New IHMC Employees: Climbing the Learning Curve