Longitudinal metrics workflow Fix #200

[jpillai00]

draft for now.. need to test this! & this is based off #282

Extends the longitudinal pipeline to compute derivative metrics (ALFF, fALFF, ReHo, smoothing, z-scoring, and atlas-based timeseries extraction) on longitudinal-space BOLD, mirroring the existing cross-sectional metrics workflow.

Key changes:

bids/longitudinal.py

• added LongitudinalMetricsInputs TypedDict, resolve_longitudinal_metrics (resolves per-regressor regressed/cleaned BOLD and brain mask from longitudinal derivatives), and export_longitudinal_metrics (delegates to existing export_metrics)

orchestration/longitudinal.py

• added process_metrics which resolves inputs, reads TR from nifti header, runs single_session_metrics, and exports outputs; added metrics and atlas_files parameters to run()

cli/longitudinal.py

• added --metrics flag and --atlas argument (defaulting to schaefer_200); TR and FWHM are not exposed as CLI params and use hardcoded defaults (read from header and 6mm respectively) to match cross-sectional behavior

No changes to workflows/metrics.py - single_session_metrics already works generically for both cross-sectional and longitudinal space.

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
rbc
__init__.py	1	0	100%
context.py	25	8	68%	70, 75–77, 79–80, 93–94
metadata.py	56	0	100%
rbc/bids
__init__.py	9	0	100%
_schema.py	585	4	99%	776, 782, 790, 1101
anatomical.py	24	3	87%	44, 47–48
builder.py	72	7	90%	233–235, 362, 364–365, 386
functional.py	43	5	88%	46–49, 84
longitudinal.py	47	2	95%	236, 272
metrics.py	23	1	95%	44
qc.py	17	0	100%
query.py	67	42	37%	103–107, 121–125, 127–128, 130–135, 137, 139, 153, 159–165, 198, 207, 209–216, 225, 257, 266–267
session.py	47	0	100%
rbc/cli
__init__.py	1	0	100%
all.py	49	2	95%	84, 109
anatomical.py	25	2	92%	47, 63
base.py	71	9	87%	56, 62, 123–125, 131–133, 156
functional.py	33	2	93%	67, 87
longitudinal.py	34	2	94%	54, 74
main.py	42	0	100%
metrics.py	42	2	95%	77, 95
qc.py	25	2	92%	45, 61
rbc/core
__init__.py	3	0	100%
common.py	26	12	53%	43–45, 62–70
fileops.py	27	4	85%	69–72
fsl2itk.py	42	0	100%
nifti.py	192	5	97%	236–237, 244–245, 524
niwrap.py	56	1	98%	58
rbc/core/anatomical
__init__.py	4	0	100%
registration.py	15	4	73%	59, 151, 166, 183
segmentation.py	24	8	66%	64, 74–76, 92, 114, 125, 141
rbc/core/functional
__init__.py	13	0	100%
coregistration.py	7	2	71%	44, 55
despiking.py	7	3	57%	32, 36–37
distortion.py	130	40	69%	269–271, 321, 324, 332–335, 341–346, 349, 352–353, 356, 365–369, 375–376, 387–388, 391, 397, 443–444, 447, 455, 461, 470–471, 474, 484, 491
erosion.py	32	1	96%	50
initialization.py	9	4	55%	35, 42–43, 63
masking.py	34	25	26%	53, 55–56, 58–59, 62–65, 69, 91, 134, 183, 197, 208, 223, 233, 249, 258, 271, 285, 296, 306, 319, 328
motion.py	57	37	35%	62, 64–67, 69, 71, 73, 76–77, 83–84, 86–87, 95–97, 99, 102, 105, 107, 124–125, 135–138, 159, 169, 171–172, 175, 177–179, 181, 183
nuisance.py	81	60	25%	78, 80–85, 87, 89–90, 93, 96–98, 100–102, 104–110, 112–116, 118, 163, 165, 167, 170–171, 173–175, 178, 181–182, 185–187, 190–193, 197, 203–205, 207, 235, 243, 269, 278, 307, 316, 322
regressors.py	89	6	93%	163, 193, 325–328
resampling.py	54	43	20%	37–42, 74–76, 78, 80–81, 85–87, 90, 93, 105, 107–108, 112, 114, 150–152, 154–155, 159, 161–162, 167–169, 173–174, 177, 180, 187, 199, 201–202, 207, 209
timing.py	16	11	31%	46–47, 49–53, 58, 60, 66–67
rbc/core/longitudinal
__init__.py	1	0	100%
transform.py	46	7	84%	106–107, 165–168, 170
rbc/core/metrics
__init__.py	3	0	100%
alff.py	90	1	98%	265
reho.py	66	0	100%
smoothing.py	7	3	57%	36, 42–43
standardization.py	27	11	59%	64, 66–68, 70, 72–75, 77–78
timeseries.py	57	1	98%	120
rbc/core/qc
__init__.py	6	0	100%
dvars.py	26	0	100%
motion.py	31	0	100%
registration.py	41	0	100%
xcp.py	41	0	100%
rbc/orchestration
__init__.py	32	2	93%	90, 93
all.py	41	9	78%	131–132, 137, 145, 153–154, 171, 173–174
anatomical.py	37	22	40%	49–52, 57–58, 60–63, 85–87, 89–90, 94, 101, 104, 109–110, 116, 118
functional.py	41	12	70%	124–126, 128–129, 133, 139, 142, 147–148, 157, 159
longitudinal.py	70	11	84%	129–130, 132, 134–137, 143, 200, 234–235
metrics.py	46	30	34%	32–35, 38–40, 67, 75–76, 100–102, 104–106, 110, 118–121, 123–124, 130–132, 137, 145, 152, 154
qc.py	34	0	100%
rbc/workflows
__init__.py	10	0	100%
anatomical.py	47	19	59%	90–93, 97–102, 107, 177–180, 182–184, 188
functional.py	111	66	40%	115–116, 124, 129–130, 138, 209–210, 213–214, 217–218, 221, 224–227, 237–239, 249–250, 253, 256, 259–260, 268–269, 276–277, 284–285, 292–293, 296–298, 301–304, 316–317, 329, 331–334, 337–338, 347–348, 356, 363, 455, 462, 465, 470, 472–474, 476–477, 483–484, 490
metrics.py	41	18	56%	80, 83–84, 93–94, 99–102, 105–108, 112–115, 119
qc.py	55	34	38%	88–89, 92–93, 96, 99, 102–107, 110, 119–121, 125–128, 130–134, 136–137, 139–141, 144, 161, 167, 169
rbc_resources
__init__.py	38	0	100%
TOTAL	3301	605	81%

Tests	Skipped	Failures	Errors	Time
729	0 💤	0 ❌	0 🔥	10.938s ⏱️

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[nx10]

Thanks @jpillai00 — reusing single_session_metrics unchanged for longitudinal space is the right call. Closing as superseded by #301; Stage 6 rewrites this against the new CLI shape (boolean --metrics goes away, becomes rbc longitudinal metrics with --atlas/--fwhm mirroring cross-sectional defaults). Port commits will carry Co-authored-by: Janhavi Pillai trailers.

Closed as part of #301 Stage 0.