{"id":19564913,"url":"https://github.com/levy-y/submarine-algorithm","last_synced_at":"2025-02-26T09:22:58.259Z","repository":{"id":231145470,"uuid":"773474959","full_name":"Levy-Y/submarine-algorithm","owner":"Levy-Y","description":"Pearlhunt project for a programming contest","archived":false,"fork":false,"pushed_at":"2024-04-03T18:07:48.000Z","size":243,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-08T23:59:32.310Z","etag":null,"topics":["algorithm","competition","python3","tkinter"],"latest_commit_sha":null,"homepage":"","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/Levy-Y.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-03-17T18:59:26.000Z","updated_at":"2024-10-18T19:02:17.000Z","dependencies_parsed_at":"2024-04-02T17:52:51.057Z","dependency_job_id":"358104e8-dad3-41bf-922e-0f310a929023","html_url":"https://github.com/Levy-Y/submarine-algorithm","commit_stats":null,"previous_names":["levy-y/submarine-algorithm"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Levy-Y%2Fsubmarine-algorithm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Levy-Y%2Fsubmarine-algorithm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Levy-Y%2Fsubmarine-algorithm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Levy-Y%2Fsubmarine-algorithm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Levy-Y","download_url":"https://codeload.github.com/Levy-Y/submarine-algorithm/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240823736,"owners_count":19863499,"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":["algorithm","competition","python3","tkinter"],"created_at":"2024-11-11T05:24:20.054Z","updated_at":"2025-02-26T09:22:58.215Z","avatar_url":"https://github.com/Levy-Y.png","language":"Python","readme":"### `Nyelvek`: **[HU]** [[EN](README_en_US.md)]\r\n\r\n# Pearlhunt: Egy Python Projekt 3D Gyöngyvadászathoz\r\n\r\nA Pearlhunt egy Python-alapú alkalmazás, amely szimulálja 3D térben a gyöngyvadászat folyamatát. Ez a projekt a Tkinter könyvtárat használja a grafikus felhasználói felület (GUI) létrehozásához, a Matplotlib-et a 3D ábrázoláshoz, és a NumPy-t numerikus műveletekhez. Az alkalmazás lehetővé teszi a felhasználóknak, hogy adatokat importáljanak egy fájlból vagy véletlenszerűen generáljanak pontokat, amelyek a 3D térben lévő gyöngyöket jelentik. Ezután egy útkereső algoritmust alkalmaz, amely meghatározza a leghatékonyabb utat a gyöngyök gyűjtéséhez, figyelembe véve értéküket és távolságukat a kiindulási ponttól (az origótól).\r\n\r\n## Funkciók\r\n\r\n- **3D Ábrázolás**: A Matplotlib segítségével ábrázolja 3D térben a gyöngyöket, lehetővé téve a felhasználók számára a gyöngyök eloszlásának megfigyelését.\r\n- **Adatimportálás**: A felhasználók importálhatnak adatokat egy fájlból, ahol minden sor egy gyöngyöt képvisel a koordinátáival és értékével.\r\n- **Véletlenszerű Pontok Generálása**: Generál egy meghatározott számú véletlenszerű gyöngyöt egy meghatározott tartományban.\r\n- **Algoritmus Végrehajtása**: Végrehajt egy MOHO (Multi-Objective Optimization Heuristic) algoritmust, amely meghatároz egy optimális utat a gyöngyök gyűjtéséhez az értékük és távolságuk alapján.\r\n- **Intelligens MOHO**: A MOHO algoritmus fejlett változata, amely optimalizálja az érték küszöbértékét a maximális gyöngygyűjtés érdekében.\r\n- **Testreszabható Paraméterek**: A felhasználók testreszabhatják a maximális koordinátákat, a gyöngyök minimális és maximális értékeit, a generálandó vagy importálandó gyöngyök számát.\r\n\r\n## Algoritmus magyarázat:\r\n[Algoritmus](algorithm_hu-HU.md)\r\n\r\n## Telepítés\r\n\r\nA Pearlhunt futtatásához győződjön meg róla, hogy a Python telepítve van a rendszerén. Ezután telepítse a szükséges könyvtárakat a pip segítségével:\r\n\r\n```batch\r\npip install matplotlib numpy customtkinter\r\n```\r\nVagy\r\n\r\n```\r\nFuttassa a setup.bat szkriptet, és beállítja az alkalmazás összes szükséges könyvtárát\r\n```\r\n\r\n## Használat\r\n\r\n1. **Futtassa az Alkalmazást**: Futtassa a Python szkriptet a Pearlhunt GUI elindításához.\r\n2. **Válassza ki az Adatforrást**: Válassza ki, hogy importálja-e az adatokat egy fájlból vagy generálja-e véletlenszerű pontokat.\r\n- **Konfigurálja a Paramétereket**: Állítsa be a maximális koordinátákat, a gyöngyök minimális és maximális értékeit, és a generálandó gyöngyök számát.\r\n3. **Konfigurálja az Algoritmust**: Állítsa be a sebességet és a rendelkezésre álló időt a kívánságainak megfelelően, és döntse el, hogy használja-e az intelligens MOHO-t (az intelligens MOHO alapértelmezetten engedélyezve van).\r\n4. **Indítsa el az Algoritmust**: Kattintson a \"Start Algorithm\" gombra, hogy futtassa a MOHO algoritmust és vizualizál egy optimális utat a gyöngyök gyűjtéséhez.\r\n5. **Mentés PDF-be**: Továbbá mentheti a gráfot egy .pdf fájlba, ha szeretné.\r\n\r\n## Screenshotok a projektről\r\n![Screenshot](https://github.com/Levy-Y/submarine-algorithm/blob/main/ScreenShots/beta-v1.0-release-screenshot.PNG)\r\n\r\n## Licensz\r\n\r\nEz a projekt az MIT Licenc alatt áll. Lásd a `LICENSE` fájlt a részletekért.\r\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flevy-y%2Fsubmarine-algorithm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flevy-y%2Fsubmarine-algorithm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flevy-y%2Fsubmarine-algorithm/lists"}