[RNG-133] LineSampler: Sample uniformly within a line

• Type: New Feature
• Status: Closed
• Priority: Minor
• Resolution: Implemented
• Affects Version/s: 1.4
• Fix Version/s: 1.4
• Component/s: sampling
• Assignee: Unassigned
• Reporter: Alex Herbert
• Created: 29/Apr/21 12:39
• Updated: 13/Sep/21 10:41
• Resolved: 03/May/21 19:49

Description

Create a sampler to sample uniformly within a line:

public abstract class LineSampler implements 
        SharedStateSampler<LineSampler> {
    public static LineSampler of(double[] a,
                                 double[] b,
                                 UniformRandomProvider rng);
}

Sampling can be performed using the same method as the TriangleSampler without the third coordinate:

v = b - a
p = a + s * v

with s a uniform deviate in [0, 1]

To allow computation with any finite coordinates the vector does not require computation:

p = a + s * (b - a)
  = a + sb - sa
  = (1 - s)a + sb

This is the same method used in the ContinuousUniformSampler but extended to N-dimensions.

Issue Links

• is a child of: RNG-132 Package rng.sampling.shape for sampling coordinates from shapes