robojackets / software-training-old

RoboJackets Software Training

RoboJackets Software Training

This is repository contains resources for the RoboJackets Software Training program.

The syllabus for training can be found here.

For student computer setup instructions, go to the setup_instructions folder.

software-training-old's Issues

Week 3: Teach std::nth_element and finding array index from iterator

They should know these for the trainii exercise for week 3 (finding the median)

Add a few notes about hotkeys to week 1

Ctrl+R
up/down arrow keys
tab completion

Project 1.3 changes

• should show a graphic of convolution on a 1d array, create your own gif
• Fix run instructions for the correct location of the build folder
• Clarify how you align the vectors, especially even kernels
• Add header string for std::stod
• make sure index -1 in the writeup is explained to not be a thing in C++.
• Be better about indicating that space for the output that should allocated.
• write out the psuedo vector you are running on 0,1,2,3,4,5,6,7,0 or 1,1,2,3,4,5,6,7,7

Speaker notes aren't working

Pressing S on a slideshow opens a popup but the HTML source is displayed rather than the page content.

Tested on latest Chrome and Edge on latest Windows.

Dynamic cast in week 4

A lot of people were confused about what dynamic casting was and how it was different from static casting since we hadn't covered polymorphism or technically even classes yet.

Week 5 topic slide improvements

• this keyword
• how to initialize an instance of a class

Virtual Machine image needs updating

#software-training/VirtualMachine_Instructions.org

Please update the virtual machine image you provided for Vitural box or for VMware, w/ ROS2 humble.
Hello, I am part of the mate ROV team at CSU Chico. These are awesome tutorials. My progress on these tutorials has been challenged by build errors and this is preventing my from recommending your coarse to other students. I was also having trouble with "Color-based Obstacle Detection" lab virtual camera not updating in Rvis with the solution code.

Fix using C style headers

https://github.com/RoboJackets/software-training/blob/f9ad1e0fa3f82a1161ab44de6adc84e8c7a4fd6c/code/week2/week2.h#L7

These should be c++ style headers

Week 4 typos

There are typos in the week 4 slides

Inconsistent directory references between projects and setup guides.

The first project and I suspect most of the following projects use the name training_ws as the workspace for training. For example

cd training_ws/src/software-training

However most of the setup guides have people creating rj_training_ws instead such as

mkdir -p rj_training_ws/src

These should be consistent because it causes confusion and unnecessary frustration especially with people who are not as familiar with command line

Convert all solutions to protected zip file

We should convert the solution files to password protected zip files to encourage them to try while still keeping the files in Git.

Images are broken in md export

https://github.com/RoboJackets/software-training/blob/gh-pages/docs/week1/week1.md.

Can be fixed by specifying file: in front of images to specify them as files to display, rather than hyperlinks.

I'll get around to this sometime tomorrow, so don't worry about it 😄

CircleCI for new training challenge

@jgkamat Would it be possible to set up a repo where we have people push their answer to a coding challenge as a pull request and have circle ci test it? This would allow for people to get experience and feedback with both coding and git while not having to wait for a person to grade it.

Unexpected nested tag(s) all projects launch .xml

Running: Ubuntu 22.04, ROS Humble, bash

Error msgs:

ros2 launch rj_training_bringup week_1.launch.xml For weeks: 1,3,5,6,8

• [ERROR] [launch]: Caught exception in launch (see debug for traceback): Caught exception when trying to load file of format [xml]: Unexpected nested tag(s) found in include: {'param'}

ros2 launch rj_training_bringup week_2.launch.xml For weeks: 2,4,7

• [ERROR] [launch]: Caught exception in launch (see debug for traceback): Caught exception when trying to load file of format [xml]: Unexpected nested tag(s) found in node: {'arg'}

Allow non-media HTTP links

https://github.com/RoboJackets/software-training/pull/17#discussion_r126735089

Organization

@jgkamat can you move everything but CI and the README to a file in slides called config?

Week 0 improvements

The week 0 session needs significant change

1. more examples of using code. Teach a concept then apply it
2. More slides on how loops work
3. more slides on how scope works with relevant examples
4. detail examples of programs to write at the end
5. a more definitive plan of what should happen after we push through the slide deck
6. A way to slow down the slides so that those that do not know everything do not get lost
7. change the programming mistakes screen and just talk about general things we have done, the ones we have are too specific and only funny if you know programming already
8. a way to advertise this session so that only those without any programming experience come

WSL Setup Instructions command does not work for everyone

The command

wsl --install --distribution Ubuntu-22.04 

in the WSL setup instructions does not work for many people. It says something about distribution not found. Will try to update issue with exact error if I can replicate.
Currently having people use this guide because that seems to work for people.

Create example setup for linux tutorial Week 1

have a recommended file tree that is ready for use with the commands we teach. This prevents people from improvising on the spot and using a command that we do not teach.

week 3 2018 changes checklist

• Call STL by full acronym
• STSL -> RJRobot
• remove ISO standard from the slide 2 quote
• add overview of STL structure (containers and algos that operate on those containers)
• ints doesn't render right
• render functions with ()
• end points to after the last element
• operator* should go with ++ and --
• begin and end return iterators, not elements (picture to show where the iterators point)
• is the copy slide useful?
• igvc robots bigoli -> jessi
• nth_element in slides
• write-up for challenge (median line sample)
• remove robot time! slide

Jay needs to add a picture in his WAI slide

Missing nav2 dependencies

Some of the packages used from nav2 aren't actually listed in any package dependencies in stsl / software_training, so they don't get installed on the student VMs.

Make diagrams for week 1 git slides

add comments to #pragma once

https://github.com/RoboJackets/software-training/blob/f9ad1e0fa3f82a1161ab44de6adc84e8c7a4fd6c/code/week2/week2.h#L1

Fix Syllabus Format on Piazza

Wut is a .doc? Who even .docs anymore?

Make a PR for week 3 git slides into week3 and not your fork

@jgkamat please. I've been bamboozled.

namespace

we do not explain namespaces well or at all.

sloh7

Update weekTwo Branch

@jgkamat Everytime I try to merge master into weekTwo github gets upset. Pls fix.

week 2 future changes

• picture of what the "open project" dialog should look like with the "hardware applications" folder selected
• lightsensor -> linesensor
• namespaces slides are confusing for people