NewBestSub/it.uniud.newbestsub.utils/Tools

Tools

Utility helpers for filename sanitization, run-token construction, and deterministic seeding.

The functions here are pure and side-effect free. They are used by the CLI and dataset layers to build stable, human-readable folder names and to derive reproducible seeds from a parameter set.

Functions

buildContainerFolderName

fun buildContainerFolderName(datasetName: String, correlationMethod: String, numberOfTopics: Int, numberOfSystems: Int, populationSize: Int, numberOfIterations: Int, numberOfRepetitions: Int, expansionCoefficient: Int, includePercentiles: Boolean, percentiles: List<Int>): String

Builds a container folder name (target-agnostic) by appending a run timestamp to the parameter token produced by buildParamsToken.

buildParamsToken

fun buildParamsToken(datasetName: String, correlationMethod: String, numberOfTopics: Int, numberOfSystems: Int, populationSize: Int, numberOfIterations: Int, numberOfRepetitions: Int, expansionCoefficient: Int, includePercentiles: Boolean, percentiles: List<Int>): String

Builds the parameter token used in filenames and containers (without timestamp and target).

folderBaseName

fun folderBaseName(vararg parts: Any?): String

Builds a base name by joining sanitized, non-blank parts with the global file name separator.

sanitizeForFile

fun sanitizeForFile(part: String): String

Sanitizes an arbitrary string so that it is safe to use as part of a filename or path segment.

stableSeedFrom

fun stableSeedFrom(p: Parameters): Long

Builds a deterministic 64-bit seed from a Parameters snapshot.