marina 0.2.2

A dataset manager for robotics to organize, share, and discover datasets and metadata across storage backends.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

# marina

**Marina** is a dataset manager for robotics built to organize, share, and discover bags and datasets across teams and storage backends.

See the [Documentation](https://stelzo.codeberg.page/marina/) for more information or the [ROS installation](https://stelzo.codeberg.page/marina/installation/ros.html) directly for the `ros2 bag` CLI extension.

## ROS 2 CLI

While Marina's dynamic autocomplete for modern shells is designed to work as a standalone tool, we provide a ROS 2 CLI mapping to ensure a more familiar user experience.

```bash
# Pull a dataset from any configured registry...
ros2 bag pull dlg_feldtage_24:cut

# and pass it straight to playback.
ros2 bag play $(ros2 bag resolve dlg_feldtage_24:cut)

# See available bags from configured remotes...
ros2 bag datasets --remote
# or use the alias.
ros2 bag ds --remote
```

Datasets are pulled from remote registries. You can easily create your own using SSH, Google Drive, HTTP or any filesystem folder.

```bash
# Record to local cache...
ros2 bag record --all -o $(ros2 bag import my_recording:session1)

# and push to your registry.
ros2 bag push my-run:v1 /path/to/bag/ --registry team_ssh
```

## Standalone

Marina supports Linux and MacOS environments without additional requirements. Just [install](https://stelzo.codeberg.page/marina/installation/packages.html) and run.

```bash
# Pull a dataset from any configured registry.
marina pull dlg_feldtage_24:cut

# Get and use the data from the local cache.
cat $(marina resolve dlg_feldtage_24:cut)/metadata.yaml

# See available bags from configured remotes...
marina list --remote
# or use the alias.
marina ls --remote

# Push any folder or bags to your registry.
marina bag push my-run:v1 /path/to/dataset/ --registry team_ssh
```

---

### License

<sup>
Licensed under either of <a href="https://codeberg.org/stelzo/marina/src/branch/main/LICENSE-APACHE">Apache License, Version
2.0</a> or <a href="https://codeberg.org/stelzo/marina/src/branch/main/LICENSE-MIT">MIT license</a> at your option.
</sup>

<br>

<sub>
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in this crate by you, as defined in the Apache-2.0 license, shall
be dual licensed as above, without any additional terms or conditions.
</sub>