Record Class LmdbPageCardinalityEstimator.Estimate

java.lang.Object
java.lang.Record
org.eclipse.rdf4j.sail.lmdb.estimate.LmdbPageCardinalityEstimator.Estimate
Record Components:
entries - rounded point estimate, clamped to the hard bounds
exact - whether the point estimate is known exactly
exhaustive - whether the selected structural plan was completely measured
hardLowerBound - records proven to match
hardUpperBound - greatest count still permitted by exact metadata and measurements
effectiveSampleSize - concentration-adjusted number of independent leaf observations
effectiveSampleFraction - effective sample size divided by the number of probes
sampledMassFraction - fraction of the estimate contributed by sampled rather than exact mass
relativeStandardError - conservative relative sampling error estimate
disagreement - largest multiplicative disagreement among independent evidence streams
physicalPilotDisagreement - physical-range estimate versus the residual pilot's range estimate
pilotFinalDisagreement - residual pilot estimate versus the final residual estimate
directRatioDisagreement - directly weighted matches versus physical mass times sampled match ratio
lowEffectiveSample - whether repeated or concentrated probes weakened effective coverage
disagreementDetected - whether any evidence streams exceeded the disagreement threshold
additionalEvidenceUsed - whether a conditional confirmation stream was read
secondaryEvidenceRecommended - whether a separate index layout should corroborate this result
physicalProbeBudgetUsed - requested probes for physical range mass
residualPilotProbeBudgetUsed - requested probes for the residual pilot
residualFinalProbeBudgetUsed - requested probes for the selected residual budget
conditionalProbeBudgetUsed - requested probes for conditional confirmations
Enclosing class:
LmdbPageCardinalityEstimator
public static record LmdbPageCardinalityEstimator.Estimate(long entries, boolean exact, boolean exhaustive, long hardLowerBound, long hardUpperBound, double effectiveSampleSize, double effectiveSampleFraction, double sampledMassFraction, double relativeStandardError, double disagreement, double physicalPilotDisagreement, double pilotFinalDisagreement, double directRatioDisagreement, boolean lowEffectiveSample, boolean disagreementDetected, boolean additionalEvidenceUsed, boolean secondaryEvidenceRecommended, int physicalProbeBudgetUsed, int residualPilotProbeBudgetUsed, int residualFinalProbeBudgetUsed, int conditionalProbeBudgetUsed) extends Record
Estimate and reliability evidence used by TripleStore to decide whether another physical index is worth reading.

  • Constructor Details

    • Estimate

      public Estimate(long entries, boolean exact, boolean exhaustive, long hardLowerBound, long hardUpperBound, double effectiveSampleSize, double effectiveSampleFraction, double sampledMassFraction, double relativeStandardError, double disagreement, double physicalPilotDisagreement, double pilotFinalDisagreement, double directRatioDisagreement, boolean lowEffectiveSample, boolean disagreementDetected, boolean additionalEvidenceUsed, boolean secondaryEvidenceRecommended, int physicalProbeBudgetUsed, int residualPilotProbeBudgetUsed, int residualFinalProbeBudgetUsed, int conditionalProbeBudgetUsed)
      Creates an instance of a Estimate record class.
      Parameters:
      entries - the value for the entries record component
      exact - the value for the exact record component
      exhaustive - the value for the exhaustive record component
      hardLowerBound - the value for the hardLowerBound record component
      hardUpperBound - the value for the hardUpperBound record component
      effectiveSampleSize - the value for the effectiveSampleSize record component
      effectiveSampleFraction - the value for the effectiveSampleFraction record component
      sampledMassFraction - the value for the sampledMassFraction record component
      relativeStandardError - the value for the relativeStandardError record component
      disagreement - the value for the disagreement record component
      physicalPilotDisagreement - the value for the physicalPilotDisagreement record component
      pilotFinalDisagreement - the value for the pilotFinalDisagreement record component
      directRatioDisagreement - the value for the directRatioDisagreement record component
      lowEffectiveSample - the value for the lowEffectiveSample record component
      disagreementDetected - the value for the disagreementDetected record component
      additionalEvidenceUsed - the value for the additionalEvidenceUsed record component
      secondaryEvidenceRecommended - the value for the secondaryEvidenceRecommended record component
      physicalProbeBudgetUsed - the value for the physicalProbeBudgetUsed record component
      residualPilotProbeBudgetUsed - the value for the residualPilotProbeBudgetUsed record component
      residualFinalProbeBudgetUsed - the value for the residualFinalProbeBudgetUsed record component
      conditionalProbeBudgetUsed - the value for the conditionalProbeBudgetUsed record component

  • Method Details

    • toString

      public final String toString()
      Returns a string representation of this record class. The representation contains the name of the class, followed by the name and value of each of the record components.
      Specified by:
      toString in class Record
      Returns:
      a string representation of this object

    • hashCode

      public final int hashCode()
      Returns a hash code value for this object. The value is derived from the hash code of each of the record components.
      Specified by:
      hashCode in class Record
      Returns:
      a hash code value for this object

    • equals

      public final boolean equals(Object o)
      Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal. All components in this record class are compared with the compare method from their corresponding wrapper classes.
      Specified by:
      equals in class Record
      Parameters:
      o - the object with which to compare
      Returns:
      true if this object is the same as the o argument; false otherwise.

    • entries

      public long entries()
      Returns the value of the entries record component.
      Returns:
      the value of the entries record component

    • exact

      public boolean exact()
      Returns the value of the exact record component.
      Returns:
      the value of the exact record component

    • exhaustive

      public boolean exhaustive()
      Returns the value of the exhaustive record component.
      Returns:
      the value of the exhaustive record component

    • hardLowerBound

      public long hardLowerBound()
      Returns the value of the hardLowerBound record component.
      Returns:
      the value of the hardLowerBound record component

    • hardUpperBound

      public long hardUpperBound()
      Returns the value of the hardUpperBound record component.
      Returns:
      the value of the hardUpperBound record component

    • effectiveSampleSize

      public double effectiveSampleSize()
      Returns the value of the effectiveSampleSize record component.
      Returns:
      the value of the effectiveSampleSize record component

    • effectiveSampleFraction

      public double effectiveSampleFraction()
      Returns the value of the effectiveSampleFraction record component.
      Returns:
      the value of the effectiveSampleFraction record component

    • sampledMassFraction

      public double sampledMassFraction()
      Returns the value of the sampledMassFraction record component.
      Returns:
      the value of the sampledMassFraction record component

    • relativeStandardError

      public double relativeStandardError()
      Returns the value of the relativeStandardError record component.
      Returns:
      the value of the relativeStandardError record component

    • disagreement

      public double disagreement()
      Returns the value of the disagreement record component.
      Returns:
      the value of the disagreement record component

    • physicalPilotDisagreement

      public double physicalPilotDisagreement()
      Returns the value of the physicalPilotDisagreement record component.
      Returns:
      the value of the physicalPilotDisagreement record component

    • pilotFinalDisagreement

      public double pilotFinalDisagreement()
      Returns the value of the pilotFinalDisagreement record component.
      Returns:
      the value of the pilotFinalDisagreement record component

    • directRatioDisagreement

      public double directRatioDisagreement()
      Returns the value of the directRatioDisagreement record component.
      Returns:
      the value of the directRatioDisagreement record component

    • lowEffectiveSample

      public boolean lowEffectiveSample()
      Returns the value of the lowEffectiveSample record component.
      Returns:
      the value of the lowEffectiveSample record component

    • disagreementDetected

      public boolean disagreementDetected()
      Returns the value of the disagreementDetected record component.
      Returns:
      the value of the disagreementDetected record component

    • additionalEvidenceUsed

      public boolean additionalEvidenceUsed()
      Returns the value of the additionalEvidenceUsed record component.
      Returns:
      the value of the additionalEvidenceUsed record component

    • secondaryEvidenceRecommended

      public boolean secondaryEvidenceRecommended()
      Returns the value of the secondaryEvidenceRecommended record component.
      Returns:
      the value of the secondaryEvidenceRecommended record component

    • physicalProbeBudgetUsed

      public int physicalProbeBudgetUsed()
      Returns the value of the physicalProbeBudgetUsed record component.
      Returns:
      the value of the physicalProbeBudgetUsed record component

    • residualPilotProbeBudgetUsed

      public int residualPilotProbeBudgetUsed()
      Returns the value of the residualPilotProbeBudgetUsed record component.
      Returns:
      the value of the residualPilotProbeBudgetUsed record component

    • residualFinalProbeBudgetUsed

      public int residualFinalProbeBudgetUsed()
      Returns the value of the residualFinalProbeBudgetUsed record component.
      Returns:
      the value of the residualFinalProbeBudgetUsed record component

    • conditionalProbeBudgetUsed

      public int conditionalProbeBudgetUsed()
      Returns the value of the conditionalProbeBudgetUsed record component.
      Returns:
      the value of the conditionalProbeBudgetUsed record component