{"id":18143756,"url":"https://github.com/remi-gau/bidsgnostic","last_synced_at":"2025-04-23T01:08:03.603Z","repository":{"id":104366003,"uuid":"583985852","full_name":"Remi-Gau/bidsgnostic","owner":"Remi-Gau","description":"BIDS app to view a dataset content and the events file content","archived":false,"fork":false,"pushed_at":"2025-04-21T06:13:40.000Z","size":1616,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-23T01:07:56.007Z","etag":null,"topics":["bids","bids-apps","eeg","fnirs","ieeg","meg","mri","pet","quality-control","snakebids","snakemake","visualization"],"latest_commit_sha":null,"homepage":"http://bidsgnostic.rtfd.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Remi-Gau.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-12-31T19:17:58.000Z","updated_at":"2025-04-21T06:13:43.000Z","dependencies_parsed_at":"2023-10-02T21:48:19.913Z","dependency_job_id":"20fcbafa-f210-47b9-921e-afb71958fb19","html_url":"https://github.com/Remi-Gau/bidsgnostic","commit_stats":{"total_commits":177,"total_committers":2,"mean_commits":88.5,"dds":"0.27118644067796616","last_synced_commit":"e85bf0d9c685e031184b97d17ddea60845eab462"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Remi-Gau%2Fbidsgnostic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Remi-Gau%2Fbidsgnostic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Remi-Gau%2Fbidsgnostic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Remi-Gau%2Fbidsgnostic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Remi-Gau","download_url":"https://codeload.github.com/Remi-Gau/bidsgnostic/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250349055,"owners_count":21415914,"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":["bids","bids-apps","eeg","fnirs","ieeg","meg","mri","pet","quality-control","snakebids","snakemake","visualization"],"created_at":"2024-11-01T19:08:44.520Z","updated_at":"2025-04-23T01:08:03.584Z","avatar_url":"https://github.com/Remi-Gau.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n.. image:: https://img.shields.io/badge/license-GPL3-blue.svg\n   :target: https://raw.githubusercontent.com/Remi-Gau/bidsgnostic/main/LICENSE\n   :alt: license GPL3\n.. image:: https://results.pre-commit.ci/badge/github/Remi-Gau/bidsgnostic/main.svg\n   :target: https://results.pre-commit.ci/latest/github/Remi-Gau/bidsgnostic/main\n   :alt: precommit status\n.. image:: https://readthedocs.org/projects/bidsgnostic/badge/?version=latest\n   :target: https://bidsgnostic.readthedocs.io/en/latest/?badge=latest\n   :alt: Documentation status\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n   :target: https://github.com/psf/black\n   :alt: black\n.. image:: https://img.shields.io/badge/Sourcery-enabled-brightgreen.svg\n   :target: https://sourcery.ai\n   :alt: sourcery\n.. image:: https://dl.circleci.com/status-badge/img/gh/Remi-Gau/bidsgnostic/tree/main.svg?style=svg\n   :target: https://dl.circleci.com/status-badge/redirect/gh/Remi-Gau/bidsgnostic/tree/main\n   :alt: circle ci\n\nbidsgnostic\n===========\n\nBIDS app to view:\n\n    - the dataset content\n    - events file content\n\n\nInstall from github with pip\n----------------------------\n\n.. code-block:: bash\n\n    pip install -e git+https://github.com/Remi-Gau/bidsgnostic#egg=bidsgnostic\n\n\nNote: you can re-run this command to re-install with the latest version\n\nUsage\n-----\n\nshort form\n**********\n\nparticipant level\n_________________\n\n.. code-block:: bash\n\n    bidsgnostic /path/to/bids/dir /path/to/output/dir participant --cores all\n\n.. image:: https://raw.githubusercontent.com/Remi-Gau/bidsgnostic/main/docs/images/sub-01_task-balloonanalogrisktask_run-01_events.png\n  :width: 1000\n  :alt: example particicant output\n\nSee `here for participant level interactive figure as html \u003chttps://github.com/Remi-Gau/bidsgnostic/raw/main/docs/images/sub-01_task-balloonanalogrisktask_run-01_events.html\u003e`_.\n\nFigures will not be generated if your events have more than 14 type of events.\nIf that is the case use the ``include`` argument to select which events you want to see.\n\ngroup level\n___________\n\n.. code-block:: bash\n\n    bidsgnostic_layout /path/to/bids/dir /path/to/output/dir group\n\n.. image:: https://raw.githubusercontent.com/Remi-Gau/bidsgnostic/main/docs/images/dataset-balloonanalogrisktakingtask_splitby-suffix_summary.png\n  :width: 1000\n  :alt: example group output\n\nSee `here for group level interactive figure as html \u003chttps://github.com/Remi-Gau/bidsgnostic/raw/main/docs/images/dataset-balloonanalogrisktakingtask_splitby-suffix_summary.html\u003e`_.\n\n\nall the gory details of the API\n*******************************\n\nsubject Level\n_____________\n\n.. code-block:: text\n\n    usage: bidsgnostic [-h]\n                    [--pybidsdb-dir PYBIDSDB_DIR]\n                    [--reset-db]\n                    [--force-output]\n                    [--help-snakemake]\n                    [--participant_label PARTICIPANT_LABEL [PARTICIPANT_LABEL ...]]\n                    [--exclude_participant_label EXCLUDE_PARTICIPANT_LABEL [EXCLUDE_PARTICIPANT_LABEL ...]]\n                    [--derivatives DERIVATIVES [DERIVATIVES ...]]\n                    [--log_level LOG_LEVEL]\n                    [--filter-events FILTER_EVENTS [FILTER_EVENTS ...]]\n                    [--wildcards-events WILDCARDS_EVENTS [WILDCARDS_EVENTS ...]]\n                    [--path-events PATH_EVENTS]\n                    bids_dir output_dir {participant}\n\n    Snakebids helps build BIDS Apps with Snakemake\n\n    optional arguments:\n    -h, --help              show this help message and exit\n\n    STANDARD:\n    Standard options for all snakebids apps\n\n    --pybidsdb-dir PYBIDSDB_DIR,\n                            Optional path to directory of SQLite databasefile for PyBIDS.\n                            If directory is passed and folder exists, indexing is skipped.\n                            If reset_db is called, indexing will persist\n    --reset-db,\n                            Reindex existing PyBIDS SQLite database\n    --force-output,\n                            Force output in a new directory that already has contents\n    --help-snakemake,\n                            Options to Snakemake can also be passed directly at the command-line,\n                            use this to print Snakemake usage\n\n    SNAKEBIDS:\n    Options for snakebids app\n\n    bids_dir                The directory with the input dataset formatted according to the BIDS standard.\n\n    output_dir              The directory where the output files should be stored.\n                            If you are running group level analysis this folder should be prepopulated\n                            with the results of the participant level analysis.\n\n    {participant}           Level of the analysis that will be performed.\n\n    --participant_label PARTICIPANT_LABEL [PARTICIPANT_LABEL ...],\n                            The label(s) of the participant(s) that should be analyzed.\n                            The label corresponds to sub-\u003cparticipant_label\u003e\n                            from the BIDS spec (so it does not include \"sub-\").\n                            If this parameter is not provided all subjects should be analyzed.\n                            Multiple participants can be specified with a space separated list.\n\n    --exclude_participant_label EXCLUDE_PARTICIPANT_LABEL [EXCLUDE_PARTICIPANT_LABEL ...],\n                            The label(s) of the participant(s) that should be excluded.\n                            The label corresponds to sub-\u003cparticipant_label\u003e from the BIDS spec\n                            (so it does not include \"sub-\").\n                            If this parameter is not provided all subjects should be analyzed.\n                            Multiple participants can be specified with a space separated list.\n    --derivatives DERIVATIVES [DERIVATIVES ...]\n                            Path(s) to a derivatives dataset, for folder(s)\n                            that contains multiple derivatives datasets (default: False)\n    --log_level LOG_LEVEL,\n                            The log_level level of the reporting\n                            that will be printed to the console.\n                            The default is \"0\", which means that\n                            only warnings and errors will be reported.\n                            If set to \"1\", all warnings, errors,\n                            and informational messages will be reported.\n                            If set to \"2\", all warnings, errors,\n                            informational and debug messages will be reported.\n    --include-events INCLUDE_EVENTS [INCLUDE_EVENTS ...],\n                        A list of events name to include in the plot.\n                        If none is passed then all events will be included.\n                        Must be less than 15 events.\n    --event_column EVENT_COLUMN,\n                        Name of the column containing the events.\n\n    BIDS FILTERS:\n    Filters to customize PyBIDS get() as key=value pairs\n\n    --filter-events FILTER_EVENTS [FILTER_EVENTS ...],\n                            (default: suffix=events extension=.tsv)\n\n    INPUT WILDCARDS:\n    File path entities to use as wildcards in snakemake\n\n    --wildcards-events WILDCARDS_EVENTS [WILDCARDS_EVENTS ...],\n                            (default: subject session acquisition task run)\n\n    PATH OVERRIDE:\n    Options for overriding BIDS by specifying absolute paths that include wildcards,\n    e.g.: /path/to/my_data/{subject}/t1.nii.gz\n\n    --path-events PATH_EVENTS, --path_events PATH_EVENTS\n\n\ngroup Level\n___________\n\n.. code-block:: text\n\n    usage: bidsgnostic_layout [-h]\n                              [--participant_label PARTICIPANT_LABEL [PARTICIPANT_LABEL ...]]\n                              [--plot_by PLOT_BY [PLOT_BY ...]]\n                              [--log_level {0,1,2}]\n                            bids_dir output_dir {group}\n\n    Group level diagnostic tool for BIDS datasets.\n    Plots the number of files per participant / session per:\n        - datatype,\n        - datatype / task,\n        - datatype / task and split by any other BIDS entity.\n\n    positional arguments:\n\n    bids_dir\n    output_dir\n    {group}\n\n    options:\n\n    -h, --help\n    --participant_label PARTICIPANT_LABEL [PARTICIPANT_LABEL ...]\n    --log_level {0,1,2}\n    --plot_by PLOT_BY [PLOT_BY ...]\n                            BIDS entity to split plots by.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fremi-gau%2Fbidsgnostic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fremi-gau%2Fbidsgnostic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fremi-gau%2Fbidsgnostic/lists"}