{"id":24584028,"url":"https://github.com/devxiongmao/power-flow-analysis","last_synced_at":"2025-03-17T17:25:52.325Z","repository":{"id":233243502,"uuid":"669614647","full_name":"devxiongmao/power-flow-analysis","owner":"devxiongmao","description":"A web-based application for performing power flow analysis. Built with Ruby and Sinatra, this tool allows users to upload CSV files containing load and line information, provides an interactive interface for building power flow schematics, and validates user inputs to ensure proper convergence.","archived":false,"fork":false,"pushed_at":"2025-02-20T03:28:34.000Z","size":974,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-20T03:29:28.911Z","etag":null,"topics":["ruby","sinatra"],"latest_commit_sha":null,"homepage":"https://power-flow-analysis.fly.dev","language":"HTML","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/devxiongmao.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2023-07-22T21:22:58.000Z","updated_at":"2025-02-20T03:18:25.000Z","dependencies_parsed_at":"2024-04-15T05:32:29.957Z","dependency_job_id":"bb70f7b7-39db-40d3-b759-1d8b124ab7fc","html_url":"https://github.com/devxiongmao/power-flow-analysis","commit_stats":null,"previous_names":["devxiongmao/power-flow-analysis"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devxiongmao%2Fpower-flow-analysis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devxiongmao%2Fpower-flow-analysis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devxiongmao%2Fpower-flow-analysis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devxiongmao%2Fpower-flow-analysis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devxiongmao","download_url":"https://codeload.github.com/devxiongmao/power-flow-analysis/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244076273,"owners_count":20394094,"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":["ruby","sinatra"],"created_at":"2025-01-24T04:54:24.973Z","updated_at":"2025-03-17T17:25:52.320Z","avatar_url":"https://github.com/devxiongmao.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Power Flow Analysis Tool\n\nA web-based application for performing power flow analysis. Built with Ruby and Sinatra, this tool allows users to upload CSV files containing load and line information, provides an interactive interface for building power flow schematics, and validates user inputs to ensure proper convergence.\n\n## Features\n\n- **CSV Upload**: Upload CSVs containing load and line info to define your power flow schematic.\n- **Interactive Interface**: Build your power flow schematic directly in the browser.\n- **Automatic Validation**: Ensures that all parameters and information in the CSV uploads are provided and non-null to encourage convergence.\n- **Fully Web-Based**: Access the tool from any web browser.\n\n## Installation\n\n### Prerequisites\n\nEnsure you have the following software installed:\n\n- Ruby (\u003e= 3.2.2)\n- Bundler (for managing gems)\n\n### Cloning the Repository\n\n```bash\ngit clone https://github.com/devxiongmao/power-flow-analysis.git\ncd power-flow-analysis\n```\n\n### Installing Dependencies\n\nRun the following command to install the required dependencies:\n\n```bash\nbundle install\n```\n\nAlternatively, you can use the Makefile:\n\n```bash\nmake install\n```\n\n### Running the Application\n\nTo start the application, use the following command:\n\n```bash\nmake dev\n```\n\nThe application will start locally on `http://localhost:4567`.\n\nAlternatively, you can run the app through docker. To build the image, run:\n\n```bash\nmake docker-build\n```\n\nThen to start the app, run:\n\n```bash\nmake docker-up\n```\n\n## Usage\n\n- Open your web browser and go to `http://localhost:4567`.\n- Upload your CSV file containing the load and line information for your power flow schematic.\n- Use the interactive interface to build and modify the schematic.\n- Ensure that your input data is valid and non-null for proper operation of the tool.\n\n## Testing\n\nThis project uses rspec for testing. To run tests, simply run:\n\n```bash\nmake test\n```\n\n## Try it out!\n\nThis app is deployed via [Fly.io](https://fly.io/). You can check it out [here](https://power-flow-analysis.fly.dev) and give it a whirl!\n\n## Contributing\n\nWe welcome contributions! To contribute:\n\n1. Fork the repository.\n2. Create a new branch for your feature or bug fix (`git checkout -b feature-name`).\n3. Make your changes and commit them (`git commit -am 'Add feature-name'`).\n4. Push to your fork (`git push origin feature-name`).\n5. Create a pull request.\n\nPlease make sure your changes pass the necessary tests and follow the project's code style.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevxiongmao%2Fpower-flow-analysis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevxiongmao%2Fpower-flow-analysis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevxiongmao%2Fpower-flow-analysis/lists"}