Initializing Weights

WeightInitializers.jl provides common weight initialization schemes for deep learning models.

using WeightInitializers, Random

# Fixing rng
rng = Random.MersenneTwister(42)

Random.MersenneTwister(42)

# Explicit rng call
weights = kaiming_normal(rng, 2, 5)

2×5 Matrix{Float32}:
 -0.351662   0.0171745   1.12442   -0.296372   -1.67094
 -0.281053  -0.18941    -0.724099   0.0987538   0.634549

# Default rng call
weights = kaiming_normal(2, 5)

2×5 Matrix{Float32}:
 -0.227513  -0.265372   0.265788  1.29955  -0.192836
  0.687611   0.454679  -0.433656  0.20548   0.292002

# Passing kwargs (if needed) with explicit rng call
weights_cl = kaiming_normal(rng; gain=1.0)
weights = weights_cl(2, 5)

2×5 Matrix{Float32}:
 0.484056   0.231723   0.164379   0.306147   0.18365
 0.0836414  0.666965  -0.396323  -0.711329  -0.382971

# Passing kwargs (if needed) with default rng call
weights_cl = kaiming_normal(; gain=1.0)
weights = weights_cl(2, 5)

2×5 Matrix{Float32}:
 -0.160876  -0.187646   0.18794   0.918918  -0.136356
  0.486214   0.321506  -0.306641  0.145296   0.206476

To generate weights directly on GPU, pass in a CUDA.RNG. For a complete list of supported RNG types, see Supported RNG Types.

using LuxCUDA

weights = kaiming_normal(CUDA.default_rng(), 2, 5)

2×5 CuArray{Float32, 2, CUDA.DeviceMemory}:
 -0.605804  0.872043  -0.318302  0.419817  -0.358819
 -0.312542  0.978972   0.262884  0.433392   0.978181

You can also generate Complex Numbers:

weights = kaiming_normal(CUDA.default_rng(), ComplexF32, 2, 5)

2×5 CuArray{ComplexF32, 2, CUDA.DeviceMemory}:
 0.105918+0.207893im  0.324906+0.314065im  …  -0.191487-0.0446116im
 -1.48524-0.188022im  0.040829-0.073304im     -0.593557+0.150118im

Quick examples

The package is meant to be working with deep learning libraries such as (F)Lux. All the methods take as input the chosen rng type and the dimension for the array.

weights = init(rng, dims...)

The rng is optional, if not specified a default one will be used.

weights = init(dims...)

If there is the need to use keyword arguments the methods can be called with just the rng (optionally) and the keywords to get in return a function behaving like the two examples above.

weights_init = init(rng; kwargs...)
weights = weights_init(rng, dims...)

# Or

weights_init = init(; kwargs...)
weights = weights_init(dims...)