Skip to content

Commit c3f2c42

Browse files
Update github links for .proto visualization on webots.cloud. (cyberbotics#6464)
1 parent 22eabe3 commit c3f2c42

14 files changed

Lines changed: 99 additions & 98 deletions

docs/automobile/car-and-driver-libraries.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Car and Driver Libraries
22

3-
To ease the creation of controllers for any [Car](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/abstract/Car.proto) PROTO models (or any PROTO node inherited from [Car](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/abstract/Car.proto)), two libraries are provided.
3+
To ease the creation of controllers for any [Car](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/abstract/Car.proto) PROTO models (or any PROTO node inherited from [Car](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/abstract/Car.proto)), two libraries are provided.
44
These two libraries are easy to use, provide high-level functionalities and save the user from knowing the name of the internal devices nodes ([Motors](../reference/motor.md), [Brakes](../reference/brake.md), etc.) of the car.
55
This section presents and explains how to use these two libraries.
66

docs/automobile/driver-library.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -161,7 +161,7 @@ public class Driver {
161161

162162
The `wbu_driver_set_steering_angle` function is used to steer the car, it steers the front wheels according to the Ackermann geometry (left and right wheels are not steered with the exact same angle).
163163
The angle is set in radians, a positive angle steers right and a negative angle steers left.
164-
The formulas used in order to compute the right and left angles are the following (`trackFront` and `wheelbase` are the parameters of the [Car](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/abstract/Car.proto) PROTO):
164+
The formulas used in order to compute the right and left angles are the following (`trackFront` and `wheelbase` are the parameters of the [Car](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/abstract/Car.proto) PROTO):
165165

166166

167167
```c
@@ -250,7 +250,7 @@ public class Driver {
250250

251251
The `wbu_driver_set_cruising_speed` function activates the control in cruising speed of the car, the rotational speed of the wheels is forced (respecting the geometric differential constraint) in order for the car to move at the speed given in argument of the function (in kilometers per hour).
252252
When the control in cruising speed is activated, the speed is directly applied to the wheel without any engine model simulation, therefore any call to functions like `wbu_driver_get_rpm` will raise an error.
253-
The acceleration of the car is computed using the `time0To100` field of the [Car](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/abstract/Car.proto) PROTO.
253+
The acceleration of the car is computed using the `time0To100` field of the [Car](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/abstract/Car.proto) PROTO.
254254

255255
The `wbu_driver_get_target_cruising_speed` function simply returns the target cruising speed (argument of the last call to the `wbu_driver_set_cruising_speed` function).
256256

@@ -487,7 +487,7 @@ public class Driver {
487487
*Set and get the brake intensity*
488488

489489
The `wbu_driver_set_brake_intensity` function brakes the car by increasing the `dampingConstant` coefficient of the rotational joints of each of the four wheels.
490-
The argument should be between 0.0 and 1.0, 0 means that no damping constant is added on the joints (no breaking), 1 means that the parameter `brakeCoefficient` of the [Car](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/abstract/Car.proto) PROTO is applied on the `dampingConstant` of each joint (the value will be linearly interpolated between 0 and `brakeCoefficient` for any arguments between 0 and 1).
490+
The argument should be between 0.0 and 1.0, 0 means that no damping constant is added on the joints (no breaking), 1 means that the parameter `brakeCoefficient` of the [Car](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/abstract/Car.proto) PROTO is applied on the `dampingConstant` of each joint (the value will be linearly interpolated between 0 and `brakeCoefficient` for any arguments between 0 and 1).
491491

492492
The `wbu_driver_get_brake_intensity` function simply returns the current brake intensity (argument of the last call to the `wbu_driver_set_brake_intensity` function).
493493

@@ -857,7 +857,7 @@ public class Driver {
857857

858858
The `wbu_driver_set_gear` function sets the engaged gear.
859859
An argument of `-1` is used in order to engage the reverse gear, an argument of `0` is used in order to disengaged the gearbox.
860-
Any other arguments than `0` and `-1` should be between 1 and the number of coefficients set in the `gearRatio` parameter of the [Car](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/abstract/Car.proto) PROTO.
860+
Any other arguments than `0` and `-1` should be between 1 and the number of coefficients set in the `gearRatio` parameter of the [Car](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/abstract/Car.proto) PROTO.
861861

862862
The `wbu_driver_get_gear` function returns the currently engaged gear.
863863

@@ -1073,7 +1073,7 @@ If `a`, `b` and `c` are the values of the `engineFunctionCoefficients` parameter
10731073
output_torque = c * rpm² + b * rpm + a
10741074
```
10751075

1076-
> **Note**: if the rpm is below the `engineMinRPM` parameter of the [Car](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/abstract/Car.proto) PROTO, `engineMinRPM` is used instead of the real rpm, but if the rpm is above the `engineMaxRPM` parameter, then the output torque is 0.
1076+
> **Note**: if the rpm is below the `engineMinRPM` parameter of the [Car](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/abstract/Car.proto) PROTO, `engineMinRPM` is used instead of the real rpm, but if the rpm is above the `engineMaxRPM` parameter, then the output torque is 0.
10771077
10781078
#### Electric Engine
10791079

docs/automobile/proto-nodes.md

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,11 @@
33
This section presents the set of PROTO nodes developed specifically for automobile related simulations, from the PROTO of a wheel to the PROTO of a complete car.
44

55
## Abstract PROTO Nodes
6-
- [AckermannVehicle](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/abstract/AckermannVehicle.proto) is the base class of almost all vehicles.
7-
- [VehicleWheel](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/abstract/VehicleWheel.proto) is a configurable wheel.
8-
- [VehicleLights](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/abstract/VehicleLights.proto) defines the set of lights in a standard vehicle.
9-
- [SimpleVehicle](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/abstract/SimpleVehicle.proto) is a simple example of derivating the AckermannVehicle PROTO.
10-
- [Car](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/abstract/Car.proto) is a generic model of a car derived from the AckermannVehicle PROTO.
6+
- [AckermannVehicle](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/abstract/AckermannVehicle.proto) is the base class of almost all vehicles.
7+
- [VehicleWheel](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/abstract/VehicleWheel.proto) is a configurable wheel.
8+
- [VehicleLights](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/abstract/VehicleLights.proto) defines the set of lights in a standard vehicle.
9+
- [SimpleVehicle](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/abstract/SimpleVehicle.proto) is a simple example of derivating the AckermannVehicle PROTO.
10+
- [Car](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/abstract/Car.proto) is a generic model of a car derived from the AckermannVehicle PROTO.
1111

1212
Please refer to the [Engine models](driver-library.md#engine-models) section to understand the various engine options available to equip a car.
1313

@@ -21,11 +21,11 @@ The amplitude and frequency of the sound is modulated in function of the rpm and
2121

2222
## Generic PROTO Nodes
2323

24-
- [Bus](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/Bus.proto) / [BusSimple](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/BusSimple.proto) / [BusWheel](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/BusWheel.proto)
25-
- [MotorbikeDriver](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/MotorbikeDriver.proto) / [MotorbikeSimple](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/MotorbikeSimple.proto) / [MotorbikeWheel](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/MotorbikeWheel.proto)
26-
- [ScooterDriver](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/ScooterDriver.proto) / [ScooterSimple](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/ScooterSimple.proto) / [ScooterWheel](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/ScooterWheel.proto)
27-
- [Tractor](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/Tractor.proto) / [TractorFrontWheel](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/TractorFrontWheel.proto) / [TractorRearWheel](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/TractorRearWheel.proto)
28-
- [Truck](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/Truck.proto) / [TruckSimple](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/TruckSimple.proto) / [TruckTank](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/TruckTank.proto) / [TruckTankSimple](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/TruckTankSimple.proto) / [TruckTrailer](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/TruckTrailer.proto) / [TruckTrailerSimple](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/TruckTrailerSimple.proto) / [TruckWheel](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/generic/protos/TruckWheel.proto)
24+
- [Bus](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/Bus.proto) / [BusSimple](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/BusSimple.proto) / [BusWheel](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/BusWheel.proto)
25+
- [MotorbikeDriver](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/MotorbikeDriver.proto) / [MotorbikeSimple](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/MotorbikeSimple.proto) / [MotorbikeWheel](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/MotorbikeWheel.proto)
26+
- [ScooterDriver](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/ScooterDriver.proto) / [ScooterSimple](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/ScooterSimple.proto) / [ScooterWheel](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/ScooterWheel.proto)
27+
- [Tractor](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/Tractor.proto) / [TractorFrontWheel](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/TractorFrontWheel.proto) / [TractorRearWheel](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/TractorRearWheel.proto)
28+
- [Truck](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/Truck.proto) / [TruckSimple](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/TruckSimple.proto) / [TruckTank](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/TruckTank.proto) / [TruckTankSimple](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/TruckTankSimple.proto) / [TruckTrailer](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/TruckTrailer.proto) / [TruckTrailerSimple](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/TruckTrailerSimple.proto) / [TruckWheel](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/generic/protos/TruckWheel.proto)
2929

3030
The tractor PROTO model provides a `sensorSlot` at center of the vehicle.
3131
The other heavy-weights provide four `sensorSlots` at the top, front, rear and center of the vehicles.
@@ -49,13 +49,13 @@ The rest of the positions can be seen in the [following table](#positions-of-the
4949

5050
%end
5151

52-
- [BmwX5](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/bmw/protos/BmwX5.proto) / [BmwX5Simple](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/bmw/protos/BmwX5Simple.proto)
53-
- [CitroenCZero](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/citroen/CitroenCZero.proto) / [CitroenCZeroSimple](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/citroen/CitroenCZeroSimple.proto)
54-
- [LincolnMKZ](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/lincoln/LincolnMKZ.proto) / [LincolnMKZSimple](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/lincoln/LincolnMKZSimple.proto)
55-
- [MercedesBenzSprinter](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/mercedes_benz/MercedesBenzSprinter.proto) / [MercedesBenzSprinterSimple](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/mercedes_benz/MercedesBenzSprinterSimple.proto)
56-
- [RangeRoverSportSVR](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/range_rover/RangeRoverSportSVR.proto) / [RangeRoverSportSVRSimple](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/range_rover/RangeRoverSportSVRSimple.proto)
57-
- [TeslaModel3](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/tesla/TeslaModel3.proto) / [TeslaModel3Simple](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/tesla/TeslaModel3Simple.proto)
58-
- [ToyotaPrius](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/toyota/ToyotaPrius.proto) / [ToyotaPriusSimple](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/toyota/ToyotaPriusSimple.proto)
52+
- [BmwX5](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/bmw/protos/BmwX5.proto) / [BmwX5Simple](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/bmw/protos/BmwX5Simple.proto)
53+
- [CitroenCZero](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/citroen/CitroenCZero.proto) / [CitroenCZeroSimple](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/citroen/CitroenCZeroSimple.proto)
54+
- [LincolnMKZ](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/lincoln/LincolnMKZ.proto) / [LincolnMKZSimple](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/lincoln/LincolnMKZSimple.proto)
55+
- [MercedesBenzSprinter](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/mercedes_benz/MercedesBenzSprinter.proto) / [MercedesBenzSprinterSimple](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/mercedes_benz/MercedesBenzSprinterSimple.proto)
56+
- [RangeRoverSportSVR](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/range_rover/RangeRoverSportSVR.proto) / [RangeRoverSportSVRSimple](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/range_rover/RangeRoverSportSVRSimple.proto)
57+
- [TeslaModel3](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/tesla/TeslaModel3.proto) / [TeslaModel3Simple](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/tesla/TeslaModel3Simple.proto)
58+
- [ToyotaPrius](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/toyota/ToyotaPrius.proto) / [ToyotaPriusSimple](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/toyota/ToyotaPriusSimple.proto)
5959

6060
Like the heavy-weights, the cars provide four `sensorsSlot`.
6161
The position of the central sensor slot is always 0 0 0 (which is the center of the rear wheels axis).

docs/automobile/robot-window.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Robot-window
22

33
A robot window has been created specifically for cars.
4-
It is assigned by default to each PROTO nodes inheriting from the [Car](https://webots.cloud/run?url={{ url.github_tree }}/projects/vehicles/protos/abstract/Car.proto) PROTO.
4+
It is assigned by default to each PROTO nodes inheriting from the [Car](https://webots.cloud/run?url={{ url.github_blob }}/projects/vehicles/protos/abstract/Car.proto) PROTO.
55

66
## Sections
77

docs/automobile/sumo-exporter.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Please refer to [these instructions](openstreetmap-importer.md#dependencies) to
1414

1515
If the Webots simulation has been created from the OpenStreetMap importer, then the export should be straight forward.
1616

17-
If it's not the case, you should pay attention on the use of the [Road](https://webots.cloud/run?url={{ url.github_tree }}/projects/objects/road/protos/Road.proto) and the [Crossroad](https://webots.cloud/run?url={{ url.github_tree }}/projects/objects/road/protos/Crossroad.proto) PROTO nodes.
17+
If it's not the case, you should pay attention on the use of the [Road](https://webots.cloud/run?url={{ url.github_blob }}/projects/objects/road/protos/Road.proto) and the [Crossroad](https://webots.cloud/run?url={{ url.github_blob }}/projects/objects/road/protos/Crossroad.proto) PROTO nodes.
1818
Indeed, their IDs should be unique, and the `Road.startJunction`, the `Road.endJunction` and the `Crossroad.connectedRoadIDs` fields should be filled correctly.
1919

2020
## How to use the Exporter

0 commit comments

Comments
 (0)