Page tree
Skip to end of metadata
Go to start of metadata

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 dcalvert@ihmc.us or dstephen@ihmc.us 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.

<user_home>/.gradle/gradle.properties
artifactoryUsername=yourcrowdusername
artifactoryPassword=yourcrowdpassword

Support for this tutorial is provided in the IHMC Robotics #help-desk channel. Please email dcalvert@ihmc.us or dstephen@ihmc.us 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

For more help, see https://docs.oracle.com/javase/8/docs/technotes/guides/install/install_overview.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.

/your/eclipse/eclipse.ini
-Xms2g
-Xmx6g

4. Clone Fast Runner Repository

a. Go to https://stash.ihmc.us/projects/ROB/repos/fastrunner/browse

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

  • No labels