Center for Analysis and Design of Intelligent Agents

Aims: In the final project you will be working with OpenNARS for Research, a different versions, than OpenNARS for Application with the main purpose of doing research on NARS. There exists different examples and a GUI to help you understand NARS better.

Summary: In this first part of the final project you will install OpenNARS for Research on your machine and get a first insight into some of the worlds that have been implemented so far, especially the TestChamber world.

Assuming you are working on a Ubuntu machine:

Install Java:

sudo apt install default-jre
sudo apt install default-jdk

Install maven:

sudo apt install maven

Set $JAVA_HOME:

export JAVA_HOME=$(realpath /usr/bin/javadoc | sed 's@bin/javadoc$@@')

Make new Directory:

mkdir OpenNARS
cd OpenNARS

Clone repos:

git clone https://github.com/opennars/opennars-parent.git
git clone https://github.com/opennars/opennars.git
git clone https://github.com/opennars/opennars-applications.git
git clone https://github.com/opennars/opennars-gui.git
git clone https://github.com/opennars/opennars-lab.git

Build projects:

cd opennars-parent
mvn clean install -Dmaven.javadoc.skip=true
cd ../opennars
mvn clean install -Dmaven.javadoc.skip=true
cd ../opennars-applications
mvn clean install -Dmaven.javadoc.skip=true
cd ../opennars-gui
mvn clean install -Dmaven.javadoc.skip=true
cd ../opennars-lab
mvn clean install -Dmaven.javadoc.skip=true

Start the GUI for interactive working with OpenNARS for Research:

cd opennars-lab/target
jexec opennars-lab-3.0.4-SNAPSHOT.jar

Figure 1: The GUI that should be started

Start the TestChamber

You can see the Editor menu, the NARS command line/ trace and the TestChamber world. With the editor you can change the TestChamber, add new objects, give NARS knowledge and apply different goals.

Figure 2: The Editor

Figure 3: The Trace

Figure 4: The World

In this first part of the final project you are meant to get some first experience on the OpenNARS for Research. You are not asked to write a report, but if you don't do those parts you might struggle in the next part.

Try out different things:

1. Place new objects in the world:
   1. Stone Wall
   2. Grass Floor
   3. Switch
   4. Cable
   5. Lamp
   6. …
2. Connect them in a meaningful way (e.g. Switch→Cable→Lamp)
3. Try what happens if you send a goal to NARS
4. Give NARS some predefined knowledge
   1. Common Sense
   2. If you go somewhere you will be there
   3. If you are somewhere and pick something up you will hold it
5. Give NARS a command to go to the newly placed switch/ lamp/ …
6. Try the “force action” submenu
7. Place some stone wall in between NARS and the “go-to” goal and give it the goal to go there again.
8. Give NARS the command to try things
   1. What happens in the NARS console?
   2. Open the Concept network and have a look at what happens there (Trace→Window→Concept Network)
9. Create a small world in which NARS can try things out.
10. Save the level. It will be saved in the folder where you started the GUI (in a subfolder called grid2d).
11. Have a look at the Code of the TestChamber, especially the EditorPanel.java file
    1. Especially at the “Predefined knowledge” section
       1. “common sense”
       2. “if you go to somewhere you will be there”
       3. “if you are somewhere and you pick whats there, you will hold it”
    2. And the different goals you can give the system
       1. “Try Things”
       2. “be somewhere”
       3. etc.
12. Implement your own predefined knowledge section
13. Implement your own goal
14. You can use the other goals/ knowledge sections to get a grasp on how things work.

This assignment is meant for you to get to know OpenNARS for Research, so please try to figure out as much as possible about how it behaves.

Also have a look at

1. The Microworld
2. The Perception part
3. NARPong

Including their trace and have a look at the code to see what strings are passed to NARS.