{"id":42272516,"url":"https://github.com/waterloo-rocketry/state_estimation","last_synced_at":"2026-01-27T07:28:30.977Z","repository":{"id":37680697,"uuid":"198243957","full_name":"waterloo-rocketry/state_estimation","owner":"waterloo-rocketry","description":"State Estimation Simulator Software for Waterloo Rocketry","archived":false,"fork":false,"pushed_at":"2022-06-22T04:01:55.000Z","size":7025,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2023-10-20T06:48:08.862Z","etag":null,"topics":["rocketry","state-estimation"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/waterloo-rocketry.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-07-22T14:49:00.000Z","updated_at":"2023-10-20T06:48:08.863Z","dependencies_parsed_at":"2022-07-28T19:09:54.086Z","dependency_job_id":null,"html_url":"https://github.com/waterloo-rocketry/state_estimation","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"purl":"pkg:github/waterloo-rocketry/state_estimation","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waterloo-rocketry%2Fstate_estimation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waterloo-rocketry%2Fstate_estimation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waterloo-rocketry%2Fstate_estimation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waterloo-rocketry%2Fstate_estimation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/waterloo-rocketry","download_url":"https://codeload.github.com/waterloo-rocketry/state_estimation/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waterloo-rocketry%2Fstate_estimation/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28808009,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T07:14:39.408Z","status":"ssl_error","status_checked_at":"2026-01-27T07:14:39.098Z","response_time":168,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["rocketry","state-estimation"],"created_at":"2026-01-27T07:28:29.476Z","updated_at":"2026-01-27T07:28:30.972Z","avatar_url":"https://github.com/waterloo-rocketry.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# State Estimation\n\nWaterloo Rocketry's state estimator is a tool used to determine information about the state of our rocket at any point in flight.\n\n### Installation Requirements\n\nPython 3.6 or newer is required to run the project.\n\nIt is recommended that a virtual environment be used to house the Python packages for this project. \nThis can be installed through a Windows terminal with the following:\n```\npy -m pip install --user virtualenv\npy -m venv venv\n.\\venv\\Scripts\\activate\n```\nThis can be installed in bash terminal with the following:\n```bash\npython3 -m pip install --user virtualenv\npython3 -m venv venv\nsource venv/bin/activate\n```\nOnce in the virtual environment, the required Python packages can be installed with `pip`:\n```\npip install -r requirements.txt\n```\nAs a side note, to exit the virtual environment when needed:\n```\ndeactivate\n```\n### Usage\nTo generate a data set, run `data_generator.py` which will prompt for user input.\nThis is the message output on each run of `data_generator.py`:\n```\nEnter a total mass, thrust, burn time, and noise params (pressure, temperature, acceleration, gyro, and magnetic noise). Please separate each value with a space:\n```\nAnd this is an example user input:\n```\n100 0,0,20000 60 1 1 1 1 1\n```\nWhere `100` is the total mass of the rocket (in kilograms), `0,0,20000` is the thrust generated by the rocket ([x,y,z] in newtons), `60` is the burn time (in seconds), and `1 1 1 1 1` is the sensor noise parameters (currently unused).\n\nThis will generate 2 files: `/generated_files/ground_truth.txt` and `/generated_files/sensor_data.txt` which house the generated data sets for the flight profile.\n\n### Unit Tests\nThe project has unit tests stored in the `/tests` directory. To run and check these tests, run this command in a terminal (in the project directory):\n```\npytest\n```\nFor additional information about the `pytest` package and how to used it, check out their [documentation](https://docs.pytest.org/en/stable/).\n\n### Contributing to the Project\nNew contributors are always welcome! Feel free to assign yourself to any issues marked with `good first issue`. If you see an issue that is not listed but needs addressing, please open an issue and discuss what you would like to change. If you are contributing to the project, make sure unit tests are written or updated to address your contributions. \n\nAdditionally, be sure to run the `format.sh` script after adding or making changes to the project's codebase to ensure that the new code is properly formatted!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaterloo-rocketry%2Fstate_estimation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwaterloo-rocketry%2Fstate_estimation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaterloo-rocketry%2Fstate_estimation/lists"}