nipoppy.layout.DatasetLayout

class nipoppy.layout.DatasetLayout(dpath_root, fpath_config=None)

File/directory structure for a specific dataset.

Parameters:
  • dpath_root (nipoppy.env.StrOrPathLike)

  • fpath_config (Optional[nipoppy.env.StrOrPathLike])

get_dpath_pipeline(pipeline_name, pipeline_version)

Return the path to a pipeline’s directory.

Parameters:
  • pipeline_name (str)

  • pipeline_version (str)

Return type:

pathlib.Path

get_dpath_pipeline_idp(pipeline_name, pipeline_version)

Return the path to a pipeline’s IDPs directory.

Note: This path is the same given a pipeline name and version (i.e. does not depend on participant or session).

Parameters:
  • pipeline_name (str)

  • pipeline_version (str)

Return type:

pathlib.Path

get_dpath_pipeline_output(pipeline_name, pipeline_version)

Return the path to a pipeline’s output directory.

Note: This path is the same given a pipeline name and version (i.e. does not depend on participant or session).

Parameters:
  • pipeline_name (str)

  • pipeline_version (str)

Return type:

pathlib.Path

get_dpath_pipeline_work(pipeline_name, pipeline_version, participant_id=None, session_id=None)

Return the path to a pipeline’s working directory.

Parameters:
  • pipeline_name (str)

  • pipeline_version (str)

  • participant_id (Optional[str])

  • session_id (Optional[str])

Return type:

pathlib.Path

get_dpath_pybids_db(pipeline_name, pipeline_version, participant_id=None, session_id=None)

Return the path to a pipeline’s BIDS database directory.

Parameters:
  • pipeline_name (str)

  • pipeline_version (str)

  • participant_id (Optional[str])

  • session_id (Optional[str])

Return type:

pathlib.Path

get_full_path(path)

Build a full path from a relative path.

Parameters:

path (nipoppy.env.StrOrPathLike)

Return type:

pathlib.Path

get_paths(directory=True, include_optional=False)

Return a list of all directory or file paths.

Return type:

list[pathlib.Path]

validate()

Validate that all the expected paths exist.

Return type:

bool

config
dname_pipeline_idp = 'idp'
dname_pipeline_output = 'output'
dpath_assessments: pathlib.Path
dpath_bids: pathlib.Path
dpath_code: pathlib.Path
dpath_containers: pathlib.Path
dpath_derivatives: pathlib.Path
property dpath_descriptions: list[Tuple[pathlib.Path, str]]

Return a list of directory paths and associated description strings.

Return type:

list[Tuple[pathlib.Path, str]]

dpath_downloads: pathlib.Path
dpath_logs: pathlib.Path
dpath_pipelines: pathlib.Path
dpath_post_reorg: pathlib.Path
dpath_pre_reorg: pathlib.Path
dpath_pybids_db: pathlib.Path
dpath_root
dpath_scratch: pathlib.Path
dpath_sourcedata: pathlib.Path
dpath_src_imaging: pathlib.Path
dpath_src_tabular: pathlib.Path
dpath_tabular: pathlib.Path
dpath_work: pathlib.Path
property dpaths: list[pathlib.Path]

Return a list of all required directory paths.

Return type:

list[pathlib.Path]

fpath_config: pathlib.Path
fpath_curation_status: pathlib.Path
fpath_demographics: pathlib.Path
fpath_manifest: pathlib.Path
fpath_processing_status: pathlib.Path
fpath_spec
property fpaths: list[pathlib.Path]

Return a list of all required file paths.

Return type:

list[pathlib.Path]