ViscoAnalysis.jl

ViscoAnalysis.jl is a Julia package for analysing complex-modulus (viscoelastic) data from dynamic mechanical analysis (DMA) experiments on bituminous materials (asphalt, etc.).

It provides a complete, self-contained workflow from raw Excel data to publication-quality figures and rheological model parameters.

Features

Installation

From the Julia REPL, activate the package environment and instantiate dependencies:

] activate path/to/ViscoAnalysis
] instantiate

Or add it as a development dependency from another project:

] dev path/to/ViscoAnalysis

Quick start

using ViscoAnalysis

# 1. Load all sheets from an Excel workbook
#    MPa=true  → modulus column is already in MPa
#    MPa=false → modulus column is in Pa, converted to MPa automatically
series = load_data("data.xlsx"; MPa=true)

# 2. Generate all diagnostic plots
plot_all(series, "results/"; Tref=10.0)

# 3. Fit the 2S2P1D model on the master curve at Tref = 10 °C
result = fit2S2P1D(series[1], 10.0)
println(result)

# 4. Overlay the fitted model on the master curve
plot_model_fit(series, [result], "results/"; Tref=10.0)

# 5. Evaluate the model at a specific frequency
ω = 2π * 10.0          # 10 Hz → rad/s
E_star = result(ω)
@show abs(E_star)              # |E*| [MPa]
@show angle(E_star) * 180/π   # φ   [°]

See Getting Started for a full walkthrough, or jump to the API Reference.

Workflow overview

Excel file (.xlsx)
        │
        ▼
   load_data()           → Vector{DataSeries}    (one per sheet)
        │
        ▼
build_shift_factors!()   → WLF coefficients C1, C2  stored in DataSeries
        │
        ▼
build_master_curve()     → reduced-frequency master curve at Tref
        │
        ▼
fit2S2P1D / fit1S2P1D    → FitResult  (model parameters + residual)
 / fitHS
        │
   ┌────┴─────┐
   ▼          ▼
plot_all()  plot_model_fit()   → PDF + PNG figures

Dependencies