Skip to content

Commit

Permalink
Merge pull request #6 from NunoDuarte/NunoDuarte-patch-5
Browse files Browse the repository at this point in the history
Update README.md
  • Loading branch information
NunoDuarte committed Nov 21, 2023
2 parents 7b8dcf6 + 656e755 commit 9fbfd2f
Showing 1 changed file with 47 additions and 37 deletions.
84 changes: 47 additions & 37 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,51 +13,28 @@ Gaze Dialogue Model system for iCub Humanoid Robot

# Table of Contents

- [Structure](#structure)
- [Dependencies](#dependencies)
- [Building](#building)
- [Instructions](#instructions-for-a-dual-computer-system)
- [Dependencies](#dependencies)
- [Setup](#setup)
- [Structure](#structure)
- [Instructions](#instructions-for-a-dual-computer-system)
- [Extras](#extras)
- [Issues](#issues)
- [Citation](#citation)
- [Contributing](#contributing)
- [License](#license)


## Structure
``` text
.
├─── Controller
├── CMakeLists.txt
├── app
│   ├── GazeDialogue_follower.xml
| ├── GazeDialogue_leader.xml
| └── iCub_startup.xml
|
├── include
│   ├── compute.h
│   ├── configure.h
| ├── helpers.h
| └── init.h
└── src
├── icub_follower.cpp
├── icub_leader.cpp
└── extras
├── CvHMM.h
├── CvMC.h
├── compute.cpp
├── configure.cpp
├── detector.cpp
└── helpers.cpp
├─── Detection
├── main.py | main_offline.py
├── face_detector.py | face_detector_gpu.py
├── objt_tracking.py
├── gaze_behaviour.py
└── pupil_lsl_yarp.py
## Building
1. clone repository
```
git clone git@github.com:NunoDuarte/GazeDialogue.git
```
2. build the controller App (have a look at [Structure](#structure) to understand the pipeline of GazeDialogue)
```
cd controller
```
3. install dependencies for controller App in [Dependencies](#dependencies)


## Dependencies
### For controller App:
Expand Down Expand Up @@ -104,7 +81,6 @@ export PYTHONPATH=$PYTHONPATH:$(pwd):$(pwd)/object_detection
- PupilLabs - [Pupil Capture](https://github.com/pupil-labs/pupil) (tested on v1.7.42)
- Pupil ROS [plugin](https://github.com/qian256/pupil_ros_plugin.git)

## Building

## Setup
### Robot as a Follower:
Expand Down Expand Up @@ -134,6 +110,40 @@ Run on the real robot - without right arm (optional). Firstly, start iCubStartup
- fingersTuner icub-laptop
- imuFilter pc104

## Structure
``` text
.
├─── Controller
├── CMakeLists.txt
├── app
│   ├── GazeDialogue_follower.xml
| ├── GazeDialogue_leader.xml
| └── iCub_startup.xml
|
├── include
│   ├── compute.h
│   ├── configure.h
| ├── helpers.h
| └── init.h
└── src
├── icub_follower.cpp
├── icub_leader.cpp
└── extras
├── CvHMM.h
├── CvMC.h
├── compute.cpp
├── configure.cpp
├── detector.cpp
└── helpers.cpp
├─── Detection
├── main.py | main_offline.py
├── face_detector.py | face_detector_gpu.py
├── objt_tracking.py
├── gaze_behaviour.py
└── pupil_lsl_yarp.py
```

## Instructions for a dual-computer system
In case you have the detection App and/or the connectivity App in a different computer do not forget to point YARP to where iCub is running:
- yarp namespace /icub (in case /icub is the name of the yarp network)
Expand Down

0 comments on commit 9fbfd2f

Please sign in to comment.