{"id":37702518,"url":"https://github.com/masilab/beyond_fa_microstruct_baseline","last_synced_at":"2026-01-16T13:01:41.640Z","repository":{"id":278830174,"uuid":"925456053","full_name":"MASILab/beyond_fa_microstruct_baseline","owner":"MASILab","description":"Microstructural baseline for BeyondFA challenge","archived":false,"fork":false,"pushed_at":"2025-03-20T20:41:14.000Z","size":466,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-20T22:02:51.941Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","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/MASILab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2025-01-31T23:12:04.000Z","updated_at":"2025-03-20T20:39:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"156e09c9-b1d0-4bc8-a47a-89d7a3795d1d","html_url":"https://github.com/MASILab/beyond_fa_microstruct_baseline","commit_stats":null,"previous_names":["masilab/beyond_fa_microstruct_baseline"],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/MASILab/beyond_fa_microstruct_baseline","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MASILab%2Fbeyond_fa_microstruct_baseline","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MASILab%2Fbeyond_fa_microstruct_baseline/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MASILab%2Fbeyond_fa_microstruct_baseline/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MASILab%2Fbeyond_fa_microstruct_baseline/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MASILab","download_url":"https://codeload.github.com/MASILab/beyond_fa_microstruct_baseline/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MASILab%2Fbeyond_fa_microstruct_baseline/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28478888,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":"2026-01-16T13:01:41.021Z","updated_at":"2026-01-16T13:01:41.635Z","avatar_url":"https://github.com/MASILab.png","language":"Shell","readme":"# Beyond FA Baseline\n\n\n\u003cimg src=\"https://github.com/MASILab/beyondFA_mlp/blob/main/4.png\" alt=\"Challenge Logo\" width=\"300\"\u003e\n\n## Challenge overview\nWe provide the overall structure of our challenge below. Participants are only responisble for the green \"Participant Docker\" oval -- everything else is provided on the [Beyond FA grand-challenge site](https://bfa.grand-challenge.org/).\n\n![alt text][ChallengeArchitecture]\n\n[ChallengeArchitecture]: https://github.com/MASILab/beyondFA_mlp/blob/main/fig2.png \"Challenge Architecture\"\n\nHere is an example repository for the Beyond FA challenge. This model calculates fractional anisotropy (FA) from the diffusion MRI, then finds the average value of FA in regions defined by [TractSeg](https://github.com/MIC-DKFZ/TractSeg).\n\n## Building the Docker\n\nSee `Dockerfile` for an example of setting up the Docker container. The Docker container is based the mrtrix Docker, which includes several common neuroimaging packages (e.g., MRtrix3, ANTs, FSL, Freesurfer). It also installs the following:\n\n- [`uv`](https://github.com/astral-sh/uv) for installing and running Python in a virtual environment\n- [`TractSeg`](https://github.com/MIC-DKFZ/TractSeg)\n- [`scilpy`](https://github.com/scilus/scilpy)\n\nTo build this Docker container, clone the repository and run the following command in the root directory:\n\n```bash\nDOCKER_BUILDKIT=1 sudo docker build -t beyondfa_baseline:v1.1.8 .\n```\n\nThe Docker runs the code from `scripts/entrypoint.sh`.\n\n## Running the Docker\n\nYour Docker container should be able to read input data from `/input` and write output data to `/output`. Intermediate data should be written to `/tmp`. The input data will be a `.mha` file containing the diffusion MRI data with gradient table information contained in a `.json` file. The input file will be in `/input/images/dwi-4d-brain-mri/`, with gradient table information at `/input/dwi-4d-acquisition-metadata.json`. Your Docker should write a JSON list to the output directory with the name `/output/features-128.json`. **Your JSON list must contain 128 values. You may zero-pad the list if you wish to provide fewer than 128 values.**\n\nSee `scripts/convert_mha_to_nifti.py` and `scripts/convert_json_to_bvalbvec.py` for scripts to convert the `.mha` to `.nii.gz` and the `.json` to `.bval` and `.bvec` files.\n\nTo run this Docker:\n\n```bash\ninput_dir=\".../input_data\"\noutput_dir=\".../output_data\"\n\nmkdir -p $output_dir\n\nDOCKER_NOOP_VOLUME=\"beyondfa_baseline-volume\"\nsudo docker volume create \"$DOCKER_NOOP_VOLUME\" \u003e /dev/null\nsudo docker run \\\n    -it \\\n    --platform linux/amd64 \\\n    --network none \\\n    --gpus all \\\n    --rm \\\n    --volume $input_dir:/input:ro \\\n    --volume $output_dir:/output \\\n    --volume \"$DOCKER_NOOP_VOLUME\":/tmp \\\n    beyondfa_baseline:v1.1.8\nsudo docker volume rm \"$DOCKER_NOOP_VOLUME\" \u003e /dev/null\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmasilab%2Fbeyond_fa_microstruct_baseline","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmasilab%2Fbeyond_fa_microstruct_baseline","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmasilab%2Fbeyond_fa_microstruct_baseline/lists"}