Skip to content

Commit 57f509f

Browse files
authored
Update README.md
1 parent 5310e6e commit 57f509f

File tree

1 file changed

+12
-26
lines changed

1 file changed

+12
-26
lines changed

README.md

Lines changed: 12 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,23 @@
1-
# PiedPiper 1.0 (23.04)
1+
# PiedPiper 1.0.1
22

33
## Installation
44
Download the repository and, as necessary, update installed R packages from the dependency list below.
55

66
### Dependencies
7-
data.table_1.14.6
8-
dplyr_1.0.10
9-
forcats_0.5.2
10-
ggplot2_3.4.0
11-
openxlsx_4.2.5.1
12-
psycho_0.6.1
13-
purrr_1.0.0
14-
R.matlab_3.7.0
15-
readr_2.1.3
16-
rlang_1.0.6
17-
stringr_1.5.0
18-
tibble_3.1.8
19-
tidyr_1.2.1
20-
tidyverse_1.3.2
21-
xml2_1.3.3
22-
zip_2.2.2
7+
tidyverse >= 2.0.0
8+
data.table >= 1.14.6
9+
ggplot2 >= 3.4.0
10+
glue >= 1.6.2
11+
openxlsx >= 4.2.5.1
12+
psycho >= 0.6.1
13+
R.matlab >= 3.7.0
14+
zip >= 2.2.2
2315

24-
The versions of many of these packages matter, particularly openxlsx and the tidyverse-related packages.
16+
The versions of many of these packages matter, particularly openxlsx and the tidyverse packages.
2517
Be sure to update to at least the listed versions of the dependencies above.
2618

27-
### First-time run
28-
- Use the included bootstrapped `experiment details.csv` and `rat_archive.csv` by copying them into the main folder.
29-
- Comment out the load of `run_archive.Rdata` in the `InitializeMain()` function of `main.R`.
30-
31-
For all later runs, **uncomment the load** so that it is executed, otherwise all prior data will be **lost**.
32-
3319
## Usage
34-
Throughout each day, persons responsible for running the experimental boxes (probably undergraduates) will run `app.R`, filling out the form for an individual rat's run and using the file picker (the Browse... button) to select the corresponding `.mat` file, then press Analyze. The user will be asked to examine two graphs (and possibly more, if there are any concerns raised by the initial two) to verify that the rat's weight and trial count trends are acceptable, that the data looks accurate and consistent with this rat's prior performance, etc. Once there is high confidence that the data is good and belongs to the named rat, the user will choose 'Save Run' at which point the results will be added to the arcives on disk.
20+
Throughout each day, persons responsible for running the experimental boxes (probably undergraduates) will run `app.R`, filling out the form for an individual rat's run and using the file picker (the Browse... button) to select the corresponding `.mat` file, then press Analyze. The user will be asked to examine two graphs (and possibly more, if there are any concerns raised by the initial two) to verify that the rat's weight and trial count trends are acceptable, that the data looks accurate and consistent with this rat's prior performance, etc. Once there is high confidence that the data is good and belongs to the named rat, the user will choose 'Save Run' at which point the results will be added to the archives on disk.
3521

3622
At the end of the day, the person responsible for making the assingments to be used the next day will run `supervisor-summarize.R`. It will create and open a summary .xlsx (Excel) file that displays the data and statistics for each rat that are used in choosing assignments. The supervisor will use the drop-down menus and the filename entry field to specify the configuration files that each rat should next be run on. The supervisor can also leave a note on any rat that will remain until it is cleared, intended for e.g. planning ahead.
3723

@@ -45,7 +31,7 @@ If new phase types are added, `main.R` and `supervisor-summarize.R` must be upda
4531
The new rat should be added to the `rat_archive.csv` file, either by opening it with a spreadsheet program or through R.
4632

4733
### Hearing Loss, Rat Retirement/Death, etc
48-
The `rat_archive.csv` file should be updated with the corresponding information. **Do not delete** rows (rats) from the archive, simply update their `end_date` column.
34+
The `rat_archive.csv` file should be updated with the corresponding information. **Never delete** rows (rats) from the archive, simply update their `end_date` column.
4935

5036
## Design
5137
Initial whiteboard - https://miro.com/app/board/uXjVO2HtI6U=/

0 commit comments

Comments
 (0)