{"id":21602911,"url":"https://github.com/dials/dx2","last_synced_at":"2025-03-18T13:36:52.202Z","repository":{"id":274076843,"uuid":"884167536","full_name":"dials/dx2","owner":"dials","description":"Standalone dxtbx data models","archived":false,"fork":false,"pushed_at":"2025-02-27T15:44:51.000Z","size":55,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-02-27T22:14:15.069Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dials.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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-11-06T09:15:24.000Z","updated_at":"2025-02-27T15:44:52.000Z","dependencies_parsed_at":"2025-02-14T18:22:28.338Z","dependency_job_id":"8e1ea26d-effb-4f26-bab6-1684b0ec57c7","html_url":"https://github.com/dials/dx2","commit_stats":null,"previous_names":["dials/dx2"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dials%2Fdx2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dials%2Fdx2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dials%2Fdx2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dials%2Fdx2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dials","download_url":"https://codeload.github.com/dials/dx2/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244232391,"owners_count":20420092,"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-11-24T19:14:39.831Z","updated_at":"2025-03-18T13:36:52.197Z","avatar_url":"https://github.com/dials.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dx2 - Clean C++ implementation of dxtbx data model\n\n## Quick Start\n\n- Ensure you have an environment with CMake and compilers available (see requirements.txt)\n- Dependencies:\n    - HDF5 (Required)\n    - gemmi (Required)\n    - [Eigen](https://eigen.tuxfamily.org/) (Optional, downloaded if missing)\n    - [nlohmann/json](https://github.com/nlohmann/json) (Optional, downloaded if missing)\n    - [{fmt}](https://github.com/fmtlib/fmt) (Optional, downloaded if missing)\n    - [GoogleTest](https://github.com/google/googletest) (Optional, downloaded if missing)\n\n```\nmkdir build\ncd build\ncmake ..\n```\nYou can then build with `make`, and run a test with `./tests/test_crystal`.\n\n## Writing And Running Tests\n\nSee https://google.github.io/googletest/primer.html. The `tests` subdirectory\nhas an example test.\n\nYou can run test executables directly, run `ctest`, or run `make test` (or\nvia your preferred build tool).\n\n## Using dx2 from other projects\n\n### Option 1: Already installed into the environment\n\nIn which case the normal CMake package finding should work:\n\n```cmake\nfind_package(DX2)\n```\n\n### Option 2: As a subdirectory/submodule\n\nIf you want to integrate dx2 development into your current project, you can\ncheck dx2 out into a subfolder (or submodule) of your build, and include it with:\n\n```cmake\nadd_subdirectory(path/to/dx2)\n```\n\n### Option 3: Automatically use with FetchContent\n\nIf you don't need to develop dx2 but just want to use it, you can get CMake to\nautomatically download and include it in your project with:\n\n```cmake\ninclude(FetchContent)\nFetchContent_Declare(\n    dx2\n    GIT_REPOSITORY git@github.com:dials/dx2.git\n    GIT_TAG main\n    FIND_PACKAGE_ARGS\n)\nFetchContent_MakeAvailable(dx2)\n\n...\n\n# Example adding to a target\ntarget_link_libraries(my-target PUBLIC dx2)\n```\n\n\u003e [!CAUTION]\n\u003e This is linking directly to the `main` branch. This is bad practice as it\n\u003e makes it non-trivial to ensure updates, but while the project is in the\n\u003e incubation stages we don't have a public release tag to base it on.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdials%2Fdx2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdials%2Fdx2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdials%2Fdx2/lists"}