JDN7T

Standard Tools

• Ubuntu 24.04 + ROS2 Jazzy + SAS
• DQ Robotics
• C++17 + modern CMake
• CoppeliaSim 4.7.0-rev4 + IsaacSim
• Lyx + LaTex
• Qt Creator, VS Code, PyCharm

For developers

git clone https://github.com/MarinhoLab/JDN7T.git --recursive

Contributing (based on DQ Robotics standards)

GitHub Workflow

Always create a branch and propose your contributions by means of a PR.

Add, commit and push your changes

Please indicate in your commit message, using brackets, the modified file. For instance, if you modified the class DQ_SerialManipulator, then you would do the following:

• git commit -m "[DQ_SerialManipulator] your_message_explaining_the modification."

However, if your explanation is longer or affects more than one file, you must write a more meaninful commit using a text editor, and hence would not use the -m option.

For example, this is how a longer commit would be written:

1: This commit solves issue X affecting `DQ_CLASS_A` and all its subclasses.
2:
3: [DQ_CLASS_A] Deleted variable X and included method Y to ensure correctness of model Z.
4: More specifically, Z was returning the transformation from frame A to frame B, instead 
5: of frame B to frame A, as described in Eq. (X) of paper [full reference here]. This has 
6: been fixed. 
7:
8: [DQ_CLASS_A_SUBCLASS_C] Changed method Z to comply with the modification made in 
9: DQ_CLASS_A

Workflow

To ensure each member of the group can work without destroying their computers by installing weird libraries suggested by ChatGPT, this project uses a containerised approach. Docker is your superhero tool. Use it!

• Start from the images we have control over. Examples:

FROM juanjqo/ubuntu_24_dqrobotics # Ubuntu 24.04 with DQ robotics. Source: https://github.com/Adorno-Lab/docker_recipes

FROM murilomarinho/sas:jazzy # juanjqo/ubuntu_24_dqrobotics + SAS