World¶

raisim::World class creates/manages all resources. All objects defined in the same Wolrd class instance can collide with each other unless otherwise their collision mask and group explicitly disables the collision ().

There are two ways to generate the World instance (i.e., two constuctors). The first way is to load an raisim world configuration file, which is in a form of an XML file. The second way is to generate world dynamically in code. You can also mix the two ways, by loading an XML file and dynamically adding objects.

RaiSim World Configuration File Convention¶

Most feature documentations include a world config file.

Adding New Objects¶

To add a new object of a shape X, a method named addX is used. For example, to add a sphere

raisim::World world;
auto sphere = world.addSphere(0.5, 1.0);

Here sphere is a pointer to the internal resource. It can be used to access or to modify the internal variables.

There are three hidden arguments to all object-creation methods: material, collisionGroup and collisionMask. Descriptions of the collision varaibles are given in “Collision and Contact” chapter. material argument specifies the material which governs contact dynamics. It is further explained in “Material System” chapter.

The list of objects is given in “Object” chapter.

Once an object is added, a name can be set as below

sphere.setName("ball");

A pointer to an object with a specific name can be retrieved as below

auto ball = world.getObject("ball");

An object might contain multiple bodies (i.e., articulated system). To designate each body, local index can be used. To keep the interface consistent, many methods ask for the local index even for simgle body objects. In a single body object case, local index arguments are ignored and users can simply put 0 to comply with the AIP.

Changing Simulation Parameters¶

The following paramters can be changed using the world API

Time step

RaiSim uses a fixed time step. The time step obtained and modified using getTimeStep and setTimeStep method.

API¶

class raisim::World¶

Public Functions

World()¶: Create an empty world

World(const std::string &configFile)¶: Create an world as specified in the xml config file

void exportToXml(const std::string &dir, const std::string &fileName)¶

export the world to an xml config file, which can be loaded using a constructor

Parameters

dir: directory to save the xml file
fileName: file name

void setTimeStep(double dt)¶

Parameters

set: the time step

double getTimeStep() const¶

Return: the time step

Sphere *addSphere(double radius, double mass, const std::string &material = "default", CollisionGroup collisionGroup = 1, CollisionGroup collisionMask = CollisionGroup(-1))¶

Return

pointer to the created box

Parameters

radius: radius
mass: mass
material: material of the height map (which defines the contact dynamics)
collisionGroup: read “Contact and Collision/ Collision Group and Mask”
collisionMask: read “Contact and Collision/ Collision Group and Mask”.

Box *addBox(double xLength, double yLength, double zLength, double mass, const std::string &material = "default", CollisionGroup collisionGroup = 1, CollisionGroup collisionMask = CollisionGroup(-1))¶

Return

pointer to the created box

Parameters

XLength: x dimension
YLength: y dimension
ZLength: z dimension
mass: mass
material: material of the height map (which defines the contact dynamics)
collisionGroup: read “Contact and Collision/ Collision Group and Mask”
collisionMask: read “Contact and Collision/ Collision Group and Mask”.

Cylinder *addCylinder(double radius, double height, double mass, const std::string &material = "default", CollisionGroup collisionGroup = 1, CollisionGroup collisionMask = CollisionGroup(-1))¶

Return

pointer to the created cylinder

Parameters

radius: radius
height: center-to-center distance
mass: mass
material: material of the height map (which defines the contact dynamics)
collisionGroup: read “Contact and Collision/ Collision Group and Mask”
collisionMask: read “Contact and Collision/ Collision Group and Mask”.

Capsule *addCapsule(double radius, double height, double mass, const std::string &material = "default", CollisionGroup collisionGroup = 1, CollisionGroup collisionMask = CollisionGroup(-1))¶

Return

pointer to the created capsule

Parameters

radius: radius
height: center-to-center distance
mass: mass
material: material of the height map (which defines the contact dynamics)
collisionGroup: read “Contact and Collision/ Collision Group and Mask”
collisionMask: read “Contact and Collision/ Collision Group and Mask”.

Ground *addGround(double zHeight = 0.0, const std::string &material = "default", CollisionGroup collisionMask = CollisionGroup(-1))¶

Return

pointer to the created ground

Parameters

zHeight: height of the terrain
material: material of the height map (which defines the contact dynamics)
collisionMask: read “Contact and Collision/ Collision Group and Mask”. Note that collision group of a static object is CollisionGroup(1) << 61ul

HeightMap *addHeightMap(size_t xSamples, size_t ysamples, double xSize, double ySize, double centerX, double centerY, const std::vector<double> &height, const std::string &material = "default", CollisionGroup collisionGroup = RAISIM_STATIC_COLLISION_GROUP, CollisionGroup collisionMask = CollisionGroup(-1))¶

Return