Skip to content

Commit 478d069

Browse files
committed
Improved index documentation
1 parent 4134392 commit 478d069

2 files changed

Lines changed: 52 additions & 9 deletions

File tree

Documentation/index.md

Lines changed: 50 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10,10 +10,11 @@ The experimental designs required to explore and understand neural mechanisms ar
1010

1111
For more information than what is in this document, please see the [Documentation Site](https://bruskatech.github.io/PsyForge).
1212

13-
## Making a Basic Experiment
13+
## Setting Up a New Project
1414

15-
Here is how to start making a basic experiment.
15+
Here is how to make a new project.
1616

17+
1. Create a new unity project
1718
1. Add PsyForge as a submodule to your project
1819
1. Open the Unity Package Manager (Top Menu Bar: Window > Package Manager)
1920
1. Click the plus in the top left corner and select "Install package from git URL"
@@ -24,14 +25,56 @@ Here is how to start making a basic experiment.
2425
```
2526

2627
1. Wait for the install to finish (it may take a couple minutes)
27-
1. Inherit `ExperimentBase` on your main experiment class.
28-
1. Implement the abstract methods `PreTrials`, `TrialStates`, `PracticeTrialStates`, and `PostTrials`.
28+
1. Install the rounded UI package
29+
1. Click: Window > Package Manager
30+
1. Click: + (top left)
31+
1. Click: Install package from git URL
32+
1. Paste: `https://github.com/kirevdokimov/Unity-UI-Rounded-Corners.git#v3.5.0`
33+
1. Click: Install (on the right)
34+
1. Copy everything in the Example folder into your main unity project at the top level.
35+
1. Go to the project window
36+
1. Click: Packages > PsyForge > Examples
37+
1. Copy all of the folders there into the *Assets* folder
38+
1. Copy the *Installer/resources* and *Installer/configs* folders to your game directory.
39+
- When developing the experiment, it is always on your Desktop.
40+
- When you build the experiment, it differs for each OS. In Linux and Macos, it is still on your Desktop. On Windows, it should be put inside the game folder on your desktop.
41+
- (Recommended) You can also use a symlink for all of the different options so that you don't use extra data and it keeps it up to date in your git repo.
42+
43+
```bash
44+
# Symlink option (Linux/MacOS)
45+
ln -s $(realpath Installer/resources) ~/Desktop/.
46+
ln -s $(realpath Installer/configs) ~/Desktop/.
47+
48+
# Symlink option (Windows)
49+
mklink /D <new_resource_path> <full_resource_path>
50+
mklink /D <new_config_path> <full_config_path>
51+
# Ex: mklink /D C:\Users\Name\Desktop\OpenField-1.0.1-Windows\resources C:\Users\Name\Documents\OpenField\Installer\resources
52+
53+
# Copy option (Linux/MacOS)
54+
# You can also just use your file manager (Linux) or Finder (MacOS)
55+
cp Installer/resources ~/Desktop/.
56+
cp Installer/configs ~/Desktop/.
57+
58+
# Copy option (Windows)
59+
# You can also just use a file explorer
60+
cp Install\resources\OpenField-<version>-Windows\resources C:\Users\<Name>\Desktop\OpenField-<version>-Windows\resources
61+
cp Install\resources\OpenField-<version>-Windows\configs C:\Users\<Name>\Desktop\OpenField-<version>-Windows\configs
62+
```
63+
64+
## Playing the Game
65+
66+
1. If you haven't already setup the resources and configs folder, do that first. That is explained in the section just above.
67+
1. Open the manager scene (always play from this scene)
68+
1. Go to the project window
69+
1. Click: Assets > Scenes > PsyForgeExtensions
70+
1. Double click: manager
71+
1. Click the play button at the top.
2972
30-
To see a basic example, check the [Examples folder](https://github.com/BruskaTech/PsyForge/tree/main/Example)
73+
To just see the example, check the [Examples folder](https://github.com/BruskaTech/PsyForge/tree/main/Example).
3174
32-
## Types of Experiments and Components Available
75+
## Types of Experimental Components Available
3376
34-
There are many types of experiments, but here are a few common ones and the useful components for them. There is also a list of generally useful components.
77+
There are many types of experimental compoenents, but here are a few common ones. There is also a list of generally useful components.
3578
3679
### General Components
3780

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,9 @@ The experimental designs required to explore and understand neural mechanisms ar
88

99
For more information than what is in this document, please see the [Documentation Site](https://bruskatech.github.io/PsyForge).
1010

11-
## Types of Experiments and Components Available
11+
## Types of Experimental Components Available
1212

13-
There are many types of experiments, but here are a few common ones and the useful components for them. There is also a list of generally useful components.
13+
There are many types of experimental compoenents, but here are a few common ones. There is also a list of generally useful components.
1414

1515
### General Components
1616

0 commit comments

Comments
 (0)