{"id":15554998,"url":"https://github.com/it-at-m/epitaph_ips","last_synced_at":"2025-08-21T05:32:36.680Z","repository":{"id":39795613,"uuid":"473184901","full_name":"it-at-m/epitaph_ips","owner":"it-at-m","description":"Library for Indoor Positioning purposes","archived":true,"fork":false,"pushed_at":"2024-09-27T14:09:30.000Z","size":3506,"stargazers_count":36,"open_issues_count":9,"forks_count":8,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-02-22T04:26:24.508Z","etag":null,"topics":["dartlang","flutter","indoor-localization","indoor-navigation","indoor-positioning","ips"],"latest_commit_sha":null,"homepage":"https://pub.dev/packages/epitaph_ips","language":"Dart","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/it-at-m.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2022-03-23T12:47:56.000Z","updated_at":"2024-12-11T14:56:36.000Z","dependencies_parsed_at":"2024-11-16T03:24:31.229Z","dependency_job_id":"faf89573-e671-44e2-9eeb-e856e9f1f96d","html_url":"https://github.com/it-at-m/epitaph_ips","commit_stats":{"total_commits":17,"total_committers":7,"mean_commits":"2.4285714285714284","dds":0.5882352941176471,"last_synced_commit":"b6dd9b6a2c6085d32525dda21cc10a150d2a7428"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":"it-at-m/oss-repository-en-template","purl":"pkg:github/it-at-m/epitaph_ips","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/it-at-m%2Fepitaph_ips","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/it-at-m%2Fepitaph_ips/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/it-at-m%2Fepitaph_ips/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/it-at-m%2Fepitaph_ips/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/it-at-m","download_url":"https://codeload.github.com/it-at-m/epitaph_ips/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/it-at-m%2Fepitaph_ips/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271430802,"owners_count":24758378,"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","status":"online","status_checked_at":"2025-08-21T02:00:08.990Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["dartlang","flutter","indoor-localization","indoor-navigation","indoor-positioning","ips"],"created_at":"2024-10-02T15:05:34.831Z","updated_at":"2025-08-21T05:32:36.317Z","avatar_url":"https://github.com/it-at-m.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Epitaph\n\nEpitaph has a wide array of utilities to position your user in a building. The project is intended to be used to only calculate the position on the user's device.\nIt has been written in Dart using the Flutter framework. Bluetooth Low Energy (BLE) beacons are used to make the calculations possible.\nReceived Signal Strength Indication (RSSI) values are used to calculate the user’s location in the real world.\n\n## Table of Contents\n- [About The Project](#about-the-project)\n- [Usage](#usage)\n- [Documentation](#documentation)\n- [Contributing](#contributing)\n- [Roadmap](#roadmap)\n- [License](#license)\n- [Contact](#contact)\n\n\n\n### Built With\n\nThis library has been build with:\n\n- [Flutter](https://flutter.dev/)\n\n\n\n## Usage\n\n\u003ci\u003eIn Progress\u003c/i\u003e\n\n### Tracking\n\nThe tracking system consists of multiple modules that can theoretically be used individually as well.\n\n#### Module descriptions\n\n- **Calculator** - module for calculating a raw position through the use of read values, i.e. RSSI-values from BLE beacons\n- **Filter** - module for smoothening out raw positions. This can be particularly useful when values tend to be noisy\n- **Tracker** - module that uses Calculator and Filter to contininuosly track the user's position\n- **Mapper** (inherits from Tracker) - module for tracking a user's position on a map (with correlating graph, nodes and edges)\n\n#### Calculator (abstract)\n\n- consists of `Point calculate(List\u003cBeacon\u003e)`\n- reads certain values from said list and calculates a position using those values\n- Epitaph IPS provides an implemented (nonlinear trilateration) Calculator, which uses a simple Levenberg-Marquardt algorithm\n\n#### Filter (abstract)\n\n- consists of `Point filter(Point)`, `void configFilter(Point)`, `void reset()`\n- an implemented filter should continuously take in a point, process it and save the result for upcoming processing\n- Epitaph IPS provieds an implemented filter in the form of simple unscented Kalmen filter\n\n#### Tracker\n\n- first calculates a raw position (using a Calculator), then filters the result (using a Filter)\n- the resulting position can be processed further, if need be\n- while Tracker consists of multiple methods, `void initiateTrackingCycle(List\u003cBeacon\u003e)` encompasses all relevant methods\n\n#### Mapper\n\n- inherits from Tracker\n- additionally to Tracker functionality, Mapper takes the resulting position after calculation and filtering and tries to make more sense of it in context of a a map, with correlating graphs, nodes and edges\n- consists of many additional methods, the most important one being an overrided `void initiateTrackingCycle(List\u003cBeacon\u003e)`\n\n#### Example\n\n```javascript\n//Initialize calculator\nCalculator calculator = LMA();\n\n//Very basic models for unscented Kalman filter\nMatrix fxUserLocation(Matrix x, double dt, List? args) {\n  List\u003cdouble\u003e list = [\n    x[1][0] * dt + x[0][0],\n    x[1][0],\n    x[3][0] * dt + x[2][0],\n    x[3][0]\n  ];\n  return Matrix.fromFlattenedList(list, 4, 1);\n}\n\nMatrix hxUserLocation(Matrix x, List? args) {\n  return Matrix.row([x[0][0], x[0][2]]);\n}\n\n//Sigma point function for unscented Kalman filter\nSigmaPointFunction sigmaPoints = MerweFunction(4, 0.1, 2.0, 1.0);\n\n//Initialize filter\nFilter filter = SimpleUKF(4, 2, 0.3, hxUserLocation, fxUserLocation, sigmaPoints, sigmaPoints.numberOfSigmaPoints());\n\n//Initialize tracker\nTracker tracker = Tracker(calculator, filter);\n\n//Engage tracker by calling this method with a list with at least 3 Beacon instances\ntracker.initiateTrackingCycle(...);\n\n//The result of the tracker can be called as follows\ntracker.finalPosition;\n\n//Raw calculated position and filtered position can be called as well\ntracker.calculatedPosition;\ntracker.filteredPosition;\n\n//Filter can be used independently from tracker; provide Point instance for filter method\nfilter.filter(...);\n\n//Calculator can be used independently from tracker; provide a list with at least 3 Beacon instances\ncalculator.calculate(...);\n```\n\n## Documentation\n\nLearn with the latest updates directly from our [Documentation.](https://pub.dev/documentation/epitaph_ips/latest/)\n\n\n\n\n\n## Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\nIf you have a suggestion that would make this better, please open an issue with the tag \"enhancement\", fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\nDon't forget to give the project a star! Thanks again!\n\n1. Open an issue with the tag \"enhancement\"\n2. Fork the Project\n3. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n4. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n5. Push to the Branch (`git push origin feature/AmazingFeature`)\n6. Open a Pull Request\n\nThe Flutter Team has a great guide [here](https://docs.flutter.dev/get-started/install) how to set up everything needed.\n\nWe also would suggest looking into the Flutter Team's style guide [here](https://github.com/flutter/flutter/wiki/Style-guide-for-Flutter-repo)\n\nMore about this in the [CODE_OF_CONDUCT](/CODE_OF_CONDUCT.md) file.\n\n\n\n\n\n## Roadmap\n\nSee the [open issues](#) for a full list of proposed features, known issues and out latest Roadmap.\n\n\n\n\n\n## License\n\nDistributed under the MIT License. See [LICENSE](LICENSE) file for more information.\n\n\n\n\n\n## Contact\n\nit@M -  itm.innolab@muenchen.de\n\n[join our slack channel](https://join.slack.com/t/epitaph-ips/shared_invite/zt-164oqyxvl-pNIGa9n6jA1fJZmk1h6zeg)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fit-at-m%2Fepitaph_ips","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fit-at-m%2Fepitaph_ips","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fit-at-m%2Fepitaph_ips/lists"}