Build the feature-construction portion of a spec(). This helper
configures the current CPM path that turns screened edges into subject-level
strength-style predictors. The name uses "strength" because this stage
follows the CPM tradition of constructing subject-level scores from screened
edge sets, but it is not limited to a simple raw network-strength sum:
positive and negative edges can be represented separately or collapsed into a
net score, optional weighting can be applied before the score is formed, and
edge values can be standardized within each training set before constructing
the final predictors.
Usage
cpm_construction_strength(
sign_mode = c("separate", "net"),
weight_scale = 0,
standardize_edges = FALSE
)Arguments
- sign_mode
How positive and negative screened information is represented.
"separate"constructspositive_summaryandnegative_summary, fits ajointstream from both together, and also returnspositiveandnegativepositive-only / negative-only diagnostic streams."net"constructs onenet_summary = positive_summary - negative_summaryfeature and returns a singlenetstream.- weight_scale
Non-negative scale controlling optional sigmoid-style edge weighting before strength construction.
0disables additional weighting and keeps the classic hard-threshold CPM score. Values greater than0apply the current sigmoid weighting scheme, with larger values producing a smoother transition around the selection cutoff.- standardize_edges
Logical value indicating if edge values should be standardized within each training set before CPM feature construction. If
TRUE, each edge is centered and scaled to unit variance using the training data, and the same transformation is applied again at prediction time. This follows the fold-local edge z-scoring approach described by Rapuano et al. (2020). Defaults toFALSEso the default construction stays close to the classic CPM strength workflow; set it toTRUEwhen you want this additional preprocessing step explicitly.
Examples
cpm_construction_strength()
#> $type
#> [1] "strength"
#>
#> $sign_mode
#> [1] "separate"
#>
#> $weight_scale
#> [1] 0
#>
#> $standardize_edges
#> [1] FALSE
#>
#> attr(,"class")
#> [1] "cpm_construction_spec"
cpm_construction_strength(
sign_mode = "net",
weight_scale = 0.03
)
#> $type
#> [1] "strength"
#>
#> $sign_mode
#> [1] "net"
#>
#> $weight_scale
#> [1] 0.03
#>
#> $standardize_edges
#> [1] FALSE
#>
#> attr(,"class")
#> [1] "cpm_construction_spec"