{"id":22441438,"url":"https://github.com/decargroup/miluv","last_synced_at":"2025-08-01T18:32:33.405Z","repository":{"id":247654193,"uuid":"760524152","full_name":"decargroup/miluv","owner":"decargroup","description":"A Multi-UAV Indoor Localization dataset with UWB and Vision","archived":false,"fork":false,"pushed_at":"2024-11-28T02:16:32.000Z","size":237822,"stargazers_count":5,"open_issues_count":4,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-11-28T03:21:06.908Z","etag":null,"topics":["dataset","localization","navigation","robotics","uav","ultra-wideband","vision"],"latest_commit_sha":null,"homepage":"https://decargroup.github.io/miluv/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/decargroup.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-20T15:22:59.000Z","updated_at":"2024-11-28T02:16:36.000Z","dependencies_parsed_at":"2024-11-04T16:32:32.730Z","dependency_job_id":"f3707443-c933-4dc1-a66f-4fb2a8e38577","html_url":"https://github.com/decargroup/miluv","commit_stats":null,"previous_names":["decargroup/miluv"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decargroup%2Fmiluv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decargroup%2Fmiluv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decargroup%2Fmiluv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/decargroup%2Fmiluv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/decargroup","download_url":"https://codeload.github.com/decargroup/miluv/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228397818,"owners_count":17913540,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dataset","localization","navigation","robotics","uav","ultra-wideband","vision"],"created_at":"2024-12-06T02:14:31.109Z","updated_at":"2025-08-01T18:32:33.387Z","avatar_url":"https://github.com/decargroup.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## \u003cimg src=\"https://github.com/decargroup/miluv/blob/gh-pages/assets/decar_logo.png?raw=true\" alt=\"DECAR Logo\" width=\"14\"/\u003e DECAR \u0026mdash; MILUV devkit\nWelcome to the MILUV devkit page. This Python devkit provides useful functions and examples to accompany the MILUV dataset. To begin using this devkit, clone or download and extract the repository.\n![](https://github.com/decargroup/miluv/blob/gh-pages/assets/banner_image.jpg?raw=true)\n\n## Table of Contents\n- [Changelog](#changelog)\n- [Devkit setup and installation](#devkit-setup-and-installation)\n- [Getting started with MILUV](#getting-started-with-MILUV)\n    - [Setting up the dataset](#setting-up-the-dataset)\n    - [Examples](#examples)\n- [Wiki](#wiki)\n- [License](#license)\n\n## Changelog\n03-07-2024: MILUV devkit v1.0.0 released.\n\n## Devkit setup and installation\nThe devkit requires Python 3.8 or greater. To install the devkit and its dependencies, run\n```\npip3 install .\n``` \ninside the devkit's root directory (~/path/to/project/MILUV). \n\nAlternatively, run\n```\npip3 install -e .\n```\ninside the devkit's root directory, which installs the package in-place, allowing you make changes to the code without having to reinstall every time. \n\nFor a list of all dependencies, refer to ``requirements.txt`` in the repository's root directory.\n\nTo ensure installation was completed without any errors, test the code by running\n```\npytest\n```    \nin the root directory.\n\n## Getting started with MILUV\n### Setting up the dataset\nTo get started, download the MILUV dataset. By default, the devkit expects the data for each experiment is present in **/miluv/data/EXP_NUMBER**, where EXP_NUMBER is the number of the experiment.\n\nIf you wish to change the default data location, be sure to modify the data directory in the devkit code.\n\n### Examples\nUsing the MILUV devkit, retrieving sensor data by timestamp from experiment ``1c`` can be implemented as:\n```py\nfrom miluv.data import DataLoader\nimport numpy as np\n\nmv = DataLoader(\n    \"default_3_random_0\",\n    height=False,\n)\n\ntimestamps = np.arange(0, 10, 1)  # Time in s\n\ndata_at_timestamps = mv.data_from_timestamps(timestamps)\n```\n\nThis example can be made elaborate by selecting specific robots and sensors to fetch from at the given timestamps.\n```py\nfrom miluv.data import DataLoader\nimport numpy as np\n\nmv = DataLoader(\n    \"default_3_random_0\",\n    height=False,\n)\n\ntimestamps = np.arange(0, 10, 1)  # Time in s\n\nrobots = [\"ifo001\", \"ifo002\"]  # We are leaving out ifo003\nsensors = [\"imu_px4\", \"imu_cam\"]  # Fetching just the imu data\n\ndata_at_timestamps = mv.data_from_timestamps(\n    timestamps,\n    robots,\n    sensors,\n)\n```\n\n## Wiki\nFor more information regarding the MILUV development kit, please refer to the [documentation](https://decargroup.github.io/miluv/).\n\n## License\nThis development kit is distributed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdecargroup%2Fmiluv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdecargroup%2Fmiluv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdecargroup%2Fmiluv/lists"}