{"id":26949676,"url":"https://github.com/numerous-com/solar-explorer","last_synced_at":"2025-04-02T22:17:07.787Z","repository":{"id":232163208,"uuid":"783642082","full_name":"numerous-com/solar-explorer","owner":"numerous-com","description":"The Solar Explorer is a Python app for designing solar plants which has been made to demonstrate how to build apps in Python.","archived":false,"fork":false,"pushed_at":"2024-04-08T14:40:04.000Z","size":21,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2024-05-03T18:37:01.091Z","etag":null,"topics":["marimo","pv","pvlib","python","solar"],"latest_commit_sha":null,"homepage":"https://www.numerous.com/app/public/b9bb6d9ab9414297a4603355fb020f4e","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/numerous-com.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-04-08T09:38:23.000Z","updated_at":"2024-05-03T18:37:04.980Z","dependencies_parsed_at":"2024-05-03T18:37:03.675Z","dependency_job_id":"200e562b-2a2a-4e0b-a525-0ad1c2ff227e","html_url":"https://github.com/numerous-com/solar-explorer","commit_stats":null,"previous_names":["numerous-team/solar-explorer","numerous-team/solar-designer","numerous-com/solar-explorer"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numerous-com%2Fsolar-explorer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numerous-com%2Fsolar-explorer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numerous-com%2Fsolar-explorer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numerous-com%2Fsolar-explorer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/numerous-com","download_url":"https://codeload.github.com/numerous-com/solar-explorer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246899653,"owners_count":20851899,"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":["marimo","pv","pvlib","python","solar"],"created_at":"2025-04-02T22:17:07.173Z","updated_at":"2025-04-02T22:17:07.778Z","avatar_url":"https://github.com/numerous-com.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Solar Explorer App\n\n## Description\n\nThe Solar Plant Explorer is a tool designed to facilitate the investigation and optimization of various solar plant configurations. Utilizing the power of pvlib, it enables users to predict the annual energy output based on different system setups, including panel orientation, tilt, and location. This project integrates with Marimo for an interactive application experience, allowing for dynamic configuration and visualization of solar energy production.\n\nFeel free to clone the code or visit https://www.numerous.com/app/public/b9bb6d9ab9414297a4603355fb020f4e to use the app directly from Numerous Public gallery.\n\n## Features\n\n- Load and process weather data from EPW files to simulate climate conditions.\n- Calculate solar output considering specific plant configurations, including tilt, azimuth, and number of modules.\n- Visualize monthly energy production and identify best and worst production days with detailed hour-by-hour analysis.\n- Interactive web application powered by Marimo for an enhanced user experience.\n\n## Getting Started\n\n### Prerequisites\n\n- Python 3.11\n- One or more .epw climate files located in the epw directory. Climate files can be downloaded via https://www.equaonline.com/ice4user/new_index.html.\n\n### Installation\n\n1. Clone the repository:\n```shell\ngit clone https://github.com/numerous-team/solar-designer.git\n```\n\n2. Install the required Python libraries:\n```shell\npip install -r requirements.txt\n```\n\n3. Run the app in development mode:\n```shell\nmarimo edit app.py\n```\n\n### Deploying and Sharing\nThe Numerous package is a tool that can help you deploy Python applications easily. Before you can initialize a project with Numerous, you first need to install the Numerous CLI (Command Line Interface) tool:\n\n```shell\npip install numerous\n```\n\nThen run the init command and follow the wizard. After you have initialized the app you can push it to Numerous and deploy it using:\n\n```shell\nnumerous init\nnumerous push\n```\n\nWhen you have pushed the app you will get a shareable link which you can use to view the app in your browser.\n\n### Usage\nStart by selecting a location from the dropdown menu to load the corresponding climate data.\nConfigure one or more solar plants by specifying the compass direction, tilt angle, peak power per panel, and the number of panels.\nAdd the configured plants to the calculation to see the combined annual energy production.\nExplore the monthly energy production and detailed analysis of the best and worst production days.\n\n## Contributing\nContributions are welcome! Please feel free to submit pull requests or open issues to propose features or report bugs.\n\n## License\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Disclaimer\nThe calculations and data presented by this app are for informational purposes only. Users should verify all data and use their own judgment before making any decisions based on the app's outputs.\n\n## Credits\nDeveloped using the pvlib library for solar energy system simulation and marimo for interactive web applications.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnumerous-com%2Fsolar-explorer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnumerous-com%2Fsolar-explorer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnumerous-com%2Fsolar-explorer/lists"}