CMalone-Jupiter commited on
Commit
68c980d
Β·
verified Β·
1 Parent(s): 9ce4550

Upload folder using huggingface_hub

Browse files
Files changed (2) hide show
  1. README.md +0 -67
  2. assets/.gitkeep +0 -1
README.md DELETED
@@ -1,67 +0,0 @@
1
- # python-FRED
2
- <!-- ![Zoe 2 img](assets/Zoe2-FRED.svg) -->
3
- <p align="center">
4
- <img src="assets/Zoe2-FRED.svg" alt="Zoe 2 img">
5
- </p>
6
- This repository provides the devkit tools for working with the Flooded Road Environments Dataset (FRED). This autonomous vehicle dataset has been developed to enable research into the detection of flooded roads during on-road deployment. The dataset was collected using a Renault Zoe with custom modifications to enable autonomy, including front and rear Blackfly cameras, an Ouster OS1 LiDAR, and a GNSS-corrected IMU. Data has been collected using the vehicle's sensor stack from 5 separate locations around Brisbane, Australia, both during and after flooding events. Semantic labels are provided for images to enable the development of detection methods, and corresponding position information from the GNSS-corrected IMU has been provided across sequences to additionally enable localization research for these scenarios.
7
-
8
- ## Dataset Structure
9
- We adopt the following structure for FRED to include a KITTI-style format for the dataset and the native recording format using RTmaps.
10
- ```
11
- β”œβ”€β”€ flooded # Location sequences captured during flooding events
12
- β”‚ β”œβ”€β”€ KITTI-style # Sequences in a KITTI-style format
13
- β”‚ | β”œβ”€β”€ Cambogan_20250811_113017 # Sequence by location
14
- β”‚ | | β”œβ”€β”€ back-imgs
15
- β”‚ | | | └── <timestamp>.png # Images in 'png' format
16
- β”‚ | | β”œβ”€β”€ back-labels
17
- β”‚ | | | └── <timestamp>.png # Semantic labels in 'png' format
18
- β”‚ | | β”œβ”€β”€ front-imgs
19
- β”‚ | | | └── <timestamp>.png # Images in 'png' format
20
- β”‚ | | β”œβ”€β”€ front-labels
21
- β”‚ | | | └── <timestamp>.png # Semantic labels in 'png' format
22
- β”‚ | | β”œβ”€β”€ imu
23
- β”‚ | | | └── <timestamp>.txt # IMU data formatted as a 'txt' file
24
- β”‚ | | β”œβ”€β”€ ouster
25
- β”‚ | | | └── <timestamp>.bin # Point clouds formatted as a binary file
26
- β”‚ | | └── utm
27
- β”‚ | | └── <timestamp>.txt # UTM locations formatted as a 'txt' file
28
- β”‚ | β”œβ”€β”€ ...
29
- β”‚ | └── ...
30
- β”‚ └── native-RTmaps # Sequences in native recording format
31
- β”‚ β”œβ”€β”€ Cambogan_20250811_113017 # Sequence by location
32
- β”‚ | β”œβ”€β”€ Camera_Rec # Recording files for image playback
33
- β”‚ | β”œβ”€β”€ IMU_Info_Rec # Recording files for IMU playback
34
- β”‚ | └── Ouster_Rec # Recording files for LiDAR playback
35
- β”‚ β”œβ”€β”€ ...
36
- β”‚ └── ...
37
- β”‚
38
- └── dry # Location sequences captured while 'dry'
39
- β”œβ”€β”€ KITTI-style
40
- └── native-RTmaps
41
- ```
42
-
43
- ## Data Formats
44
- ### Image Format
45
- Images are stored in PNG format.
46
-
47
- ### Point Cloud Format
48
- Point clouds are stored in binary format (.bin), with each point containing x, y, z positions, as well as reflectivity values. Reflectivity values are surface normalized signal intensity measurements that range from 0 to 255. 3D coordinates are captured in the right-hand coordinate frame with the positive x-axis in the vehicle's direction of travel.
49
-
50
- ### UTM Format
51
- UTM data is stored in text file format (.txt), with UTM x and y values being stored as space separated values in the file.
52
-
53
- ### IMU Format
54
- Additional IMU information is also stored in text file format (.txt). A space delimiter is again used to separate values. The additional IMU data is stored in the following order:
55
- ```
56
- [ Latitude, Longitude, Altitude,
57
- Roll, Pitch, Yaw,
58
- North Velocity, East Velocity,
59
- x Velocity, y Velocity, z Velocity,
60
- x Angular Velocity, y Angular Velocity, z Angular Velocity,
61
- x Angular Velocity, y Angular Velocity, z Angular Velocity,
62
- x Angular Accel, y Angular Accel, z Angular Accel,
63
- x Angular Accel, y Angular Accel, z Angular Accel,
64
- Position Accuracy, Velocity Accuracy,
65
- Navstate Value, Numstat Value,
66
- Position Mode, Velocity Mode, Orientation Mode ]
67
- ```
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
assets/.gitkeep DELETED
@@ -1 +0,0 @@
1
-