Child pages
  • Beginner Quick Start: Hex Runner Simulation
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

Email nmertins@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

2. Install JDK

You can install the JDK from here: 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 existing 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

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 Gradle 4.2. 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 seeSetting up IHMC Eclipse Workspace

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 Climbing the Learning Curve

  • No labels