{"id":17179271,"url":"https://github.com/bytehamster/mmphf-experiments","last_synced_at":"2025-03-24T23:37:21.126Z","repository":{"id":160309867,"uuid":"574510054","full_name":"ByteHamster/MMPHF-Experiments","owner":"ByteHamster","description":"Comparison of different Monotone Minimal Perfect Hashing competitors","archived":false,"fork":false,"pushed_at":"2023-06-06T12:36:50.000Z","size":369,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-01-30T02:29:26.662Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ByteHamster.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":"2022-12-05T13:23:41.000Z","updated_at":"2024-02-07T06:08:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"1ec5ccf0-f067-4051-98dd-c594328cb8c2","html_url":"https://github.com/ByteHamster/MMPHF-Experiments","commit_stats":{"total_commits":48,"total_committers":1,"mean_commits":48.0,"dds":0.0,"last_synced_commit":"ec5d0db095ce93b3e9d86f9f519de2738fe8b797"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ByteHamster%2FMMPHF-Experiments","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ByteHamster%2FMMPHF-Experiments/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ByteHamster%2FMMPHF-Experiments/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ByteHamster%2FMMPHF-Experiments/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ByteHamster","download_url":"https://codeload.github.com/ByteHamster/MMPHF-Experiments/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245372216,"owners_count":20604488,"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":[],"created_at":"2024-10-15T00:25:24.746Z","updated_at":"2025-03-24T23:37:21.088Z","avatar_url":"https://github.com/ByteHamster.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MMPHF-Experiments\n\nMonotone Minimal Perfect Hashing competitors.\n\n## Reproducing Experiments\n\nThis repository contains the source code and our reproducibility artifacts for comparing different MMPHF constructions.\n\nWe provide an easy to use Docker image to quickly reproduce our results.\nAlternatively, you can look at the `Dockerfile` to see all libraries, tools, and commands necessary to compile.\n\n#### Cloning the Repository\n\nThis repository contains submodules.\nTo clone the repository including submodules, use the following command.\n\n```\ngit clone --recursive https://github.com/ByteHamster/MMPHF-Experiments.git\n```\n\n#### Building the Docker Image\n\nRun the following command to build the Docker image.\nBuilding the image takes about 10 minutes, as some packages (including LaTeX for the plots) have to be installed.\n\n```bash\ndocker build -t mmphf_experiments --no-cache .\n```\n\nSome compiler warnings (red) are expected when building dependencies and will not prevent building the image or running the experiments.\nPlease ignore them!\n\n#### Running the Experiments\nDue to the long total running time of all experiments in our paper, we provide a run script for a highly simplified version of the experiments.\nMost importantly, we use a small, synthetic dataset (also due to licensing and download size).\n\nYou can modify the benchmark scripts in `scripts/dockerVolume` if you want to change any parameters.\nThis does not require the Docker image to recompile.\nThe experiments can be started by using the following command:\n\n```bash\ndocker run --interactive --tty -v \"$(pwd)/scripts/dockerVolume:/opt/dockerVolume\" mmphf_experiments /opt/dockerVolume/normal-distribution.sh\n```\n\nThe resulting plots can be found in `scripts/dockerVolume` and have the file extension `.pdf`.\n\n### License\n\nThe benchmark code is licensed under the [GPLv3](/LICENSE).\nThe competitors (in the `cpp/extlib` and `java/extlib` directories) are licensed with their respective licenses.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbytehamster%2Fmmphf-experiments","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbytehamster%2Fmmphf-experiments","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbytehamster%2Fmmphf-experiments/lists"}