MORSE allows the simulation of humans: you can add a human model in your scene, you can control it from the keyboard and mouse during the simulation (move it around, sit it down, pick and place objects...), and export to your robotic systems various data (currently only the position and joint state).
The human is handled inside MORSE as a robot, which means it can have sensors and actuators attached to it.
For a general introduction to human-robot interaction simulation with MORSE, check the HRI main page.
The procedure to insert a human in your simulation is slightly different than for other assets.
You can append a human while editing a scenario in Blender by importing the Human group available in $MORSE_ROOT/data/robots/human.blend.
If the model do not appear, it has probably be added to an invisible layer. Check in the layers panel.
To add a human with the MORSE Builder API, you just need to instantiate the morse.builder.morsebuilder.Human class.
from morse.builder.morsebuilder import *
human = Human()
The human posture component can then be accessed through the armature member.
Usage example:
#! /usr/bin/env morseexec
from morse.builder.morsebuilder import *
human = Human()
human.translate(x=5.5, y=-3.2, z=0.0)
human.rotate(z=-3.0)
human.armature.configure_mw('pocolibs',
['morse.middleware.pocolibs_mw.MorsePocolibsClass',
'export_posture',
'morse/middleware/pocolibs/sensors/human_posture',
'human_posture'])
When starting a simulation with a human, the active camera is automatically set behind the human, in immersive mode (so-called first-person shooter view). You can switch to another camera with the F9 key.
The human always starts in so-called Motion Mode.
To toggle in and out of Manipulation Mode, press X.
You can move the hand by holding Middle Mouse Button and moving the Mouse.
In manipulation mode, when the hand is close enough of a graspable object (see passive objects documentation to know how to define a graspable object), a label Pickup the object appears. Press the Left Mouse Button to take the item. To lay the item down, press Right Mouse Button. To precisely lay the item down, move the crosshairs over this point. If this point is in reach (and the object that the item is to be placed on is marked as Actor in Blender’s Physic settings), a green rectangle appears. Press Right Mouse Button to lay it down.
Futhermore the human can interact with doors, drawers and switches. To do so, move the crosshairs over the door/drawer/switch and press Left Mouse Button. See Setting up a Scene with MORSE Utils on how to set up the environment for the human.
Currently (morse-0.5), the human component has one sensor already integrated, which exports the joint state of the human: the human posture sensor. This sensor is already embedded in the human.blend file. You don’t need to link it from a separate sensor file.
The human model can be controlled using the keyboard, or have a motion controller attached to it, so that the movement commands can come from an external software.