User Tools

Site Tools


installation

Installing Nanoverse

This page is accurate as of Nanoverse v1.0.0-a10. If you are using a later version, some aspects may have changed.

Preliminary steps

  1. Make sure you have the Java 1.8 JDK installed on your computer. You can get it here. Java 1.8 is the same thing as Java 8.
  2. If using PETSc integration (Mac and Linux) Make sure you have a C compiler. On a Mac, you need to install Xcode (free from Apple) and the OS X dev tools. In Linux, you probably already have one.
  3. If you want to develop for Nanoverse, make sure you have git installed.

To run projects from the command line

  1. Go to the Github release page for Nanoverse and download the source code for the latest version. The .zip and .tar.gz versions have the same content; use whichever one you find familiar.
  2. Unzip the source code file into the directory where you want to install Nanoverse.
  3. From the command line, navigate to the installation directory and type gradlew build (Windows) or ./gradlew build (Mac/Linux). The program will install itself, then do a series of self-tests. Installation could take 15 minutes or more if PETSc is enabled (Mac/Linux). Four or five tests may fail when you first install; this is normal. If more than that fail, please email David for assistance.
  4. Run gradlew standaloneJar (./gradlew standaloneJar on Mac and Ubuntu).
  5. Copy build/libs/Nanoverse-all-v1.0.0-a#.jar to the root directory of Nanoverse, where # is the current build number of the alpha version of Nanoverse. Rename it to nanoverse.jar.
  6. From the Nanoverse root directory, type java -jar nanoverse.jar path/to/project/myProject.nano, where, path/to/project… is the project file that you want to simulate.

Exploring Nanoverse in IntelliJ IDEA

  1. Install IntelliJ IDEA community edition.
  2. From the command line, navigate to the directory where you want to put your copy of Nanoverse.
  3. Go into the new “nanoverse” directory.
  4. From the command line, navigate to the installation directory and type gradlew build (Windows) or ./gradlew build (Mac/Linux). The program will install itself, then do a series of self-tests. Installation could take 15 minutes or more if PETSc is enabled (Mac/Linux). Four or five tests may fail when you first install; this is normal. If more than that fail, please email David for assistance.
  5. Run gradlew idea (./gradlew idea for Mac and Linux). This will build the IDEA project.
  6. Open up IntelliJ IDEA. Choose Open… under File. Navigate to the desired nanoverse directory and choose “nanoverse.ipr” (or the equivalent if version numbers are included in the file name. E.g. “nanoverse-1.0.0-a11.ipr”. Do not double-click on the folder itself or on the .iws or .iml file.
  7. Some messages may pop up.
    • For “Unregistered VCS roots,” choose “add roots.”
    • For “Unlinked gradle project,” choose “don't want to see this message again.”
    • For anything else (OSGi, Python), ignore it.
installation.txt · Last modified: 2016/06/18 01:29 by avaneesh