Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
72 changes: 0 additions & 72 deletions .github/copilot-instructions.md

This file was deleted.

8 changes: 2 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ This project uses ROS2 Jazzy.
More details [here](./ros_workspace/)

### Tools
Assorted tools useful for BlueStar, or developing for BlueStar.
Assorted tools useful for BlueStar, or developing for BlueStar. More details [here](./Tools/)

### Assets
Assets used in BlueStar.
Expand All @@ -37,8 +37,4 @@ Assets used in BlueStar.
Tools related to the science officer tasks in the MATE 2026 mission.

### Firmware
The firmware running on BlueStar's onboard RP2040 microcontroller, which communicates with the onboard Raspberry Pi 4B via I2c, along with the PCB schematics can be found in the [Electrical_2026 Repository](https://github.com/EasternEdgeRobotics/Electrical_2026).

### Agentic AI Tools
Agentic AI tools, such as the Github Copilot Extension, should automatically use the [copilot-instructions.md](./.github/copilot-instructions.md) file for context. This file contains useful technical information for onboarding in natural language.

The firmware running on BlueStar's onboard RP2040 microcontroller, which communicates with the onboard Raspberry Pi 4B via I2c, along with the PCB schematics can be found in the [Electrical_2026 Repository](https://github.com/EasternEdgeRobotics/Electrical_2026).
23 changes: 23 additions & 0 deletions Tools/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# Tools
Various scripts / tools made to help develop BlueStar's software, these can be split into 3 catagories:

## Cameras
### [add-exif-data.sh](./add-exif-data.sh/)
Every commerical camera solution will add on extra metadata about the camera sensor taking the photo, but because the camera system in BlueStar is (somewhat) custom, we have to add it ourselves. This was the step that showed that adding metadata to the photos really improved the results from WebODM for photogramatry.

### [cv2_fisheye_calibration.py](./cv2_fisheye_calibration.py`)
The cameras used in BlueStar are naturally fisheye from the lens, in addition to that, the flat view port present on them exaggerates the effects on the camera view. This script tries to calibrate around that, but it doesn't work well.

## Photogramatry
### [upload-to-webodm.py](./upload-to-webodm.py)
Before we switched to RealityKit, (WebODM)["https://github.com/WebODM/WebODM"] was used to generate the models of the coral garden, this script acted as a little helper so that i didn't need to build WebODM API functionality into the science officer GUI, which later worked out in my favour when we switched to Apple's RealityKit. -PC

### [webodm_bruteforce.py](./webodm_bruteforce.py)
During testing of WebODM, i was trying to figure out what the minimum settings I could get away with while maintaining the quality in an attempt to lower the overall time. I don't think I actually learned anything about what improved it because all of the results were various types of awful, although some looked really funky. -PC

### [realitykit_batch_tester.sh](./realitykit_batch_tester.sh)
Reverse idea of the WebODM bruteforce script, this used a bunch of different data sets to test the reliability instead of a single dataset for testing the reliabiltiy of various settings.

## Misc
### [image_to_array.py](./image_to_array.py)
Used to add the science officer themed nosignal image to the science officer gui.
2 changes: 1 addition & 1 deletion cloudinit/README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
# Cloudinit & netplan Configs
Requires Raspberry Pi OS 13 Trixie or newer.
These configs help setup the root fs on the Pi used in BlueStar. I (PC) can't remember if the cloudinit stuff was used on the main Pi SD card, but the netplan configs were.
8 changes: 0 additions & 8 deletions cloudinit/eer-bs-pi/51-docker-bridge.yaml

This file was deleted.

1 change: 1 addition & 0 deletions science_officer/Iceberg/.python-version
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
3.13
14 changes: 11 additions & 3 deletions science_officer/Iceberg/README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,18 @@
# Iceberg Mapping
## Iceberg Mapper
Requires the following python packages:
## Required Packages
### pip
Generic:
```
pip install matplotlib tk
pip install matplotlib tk opencv-python numpy
```

### uv
Sync the repo with uv.
```
uv sync
```

## Iceberg Mapper

## Iceberg Depth
### Keys:
Expand Down
12 changes: 12 additions & 0 deletions science_officer/Iceberg/pyproject.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
[project]
name = "iceberg"
version = "1.0.0"
description = "Eastern Edge's 2026 Iceberg Task Solutions"
readme = "README.md"
requires-python = ">=3.13"
dependencies = [
"matplotlib>=3.11.0",
"numpy>=2.5.1",
"opencv-python>=5.0.0.93",
"tk>=0.1.0",
]
Loading