Class Distribution.Builder (2.44.0)

public static final class Distribution.Builder extends GeneratedMessageV3.Builder<Distribution.Builder> implements DistributionOrBuilder

Distribution contains summary statistics for a population of values. It optionally contains a histogram representing the distribution of those values across a set of buckets.

The summary statistics are the count, mean, sum of the squared deviation from the mean, the minimum, and the maximum of the set of population of values. The histogram is based on a sequence of buckets and gives a count of values that fall into each bucket. The boundaries of the buckets are given either explicitly or by formulas for buckets of fixed or exponentially increasing widths.

Although it is not forbidden, it is generally a bad idea to include non-finite values (infinities or NaNs) in the population of values, as this will render the mean and sum_of_squared_deviation fields meaningless.

Protobuf type google.api.Distribution

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
Type Description
Descriptor

Methods

addAllBucketCounts(Iterable<? extends Long> values)

public Distribution.Builder addAllBucketCounts(Iterable<? extends Long> values)

The number of values in each bucket of the histogram, as described in bucket_options. If the distribution does not have a histogram, then omit this field. If there is a histogram, then the sum of the values in bucket_counts must equal the value in the count field of the distribution.

If present, bucket_counts should contain N values, where N is the number of buckets specified in bucket_options. If you supply fewer than N values, the remaining values are assumed to be 0.

The order of the values in bucket_counts follows the bucket numbering schemes described for the three bucket types. The first value must be the count for the underflow bucket (number 0). The next N-2 values are the counts for the finite buckets (number 1 through N-2). The N'th value in bucket_counts is the count for the overflow bucket (number N-1).

repeated int64 bucket_counts = 7;

Parameter
Name Description
values Iterable<? extends java.lang.Long>

The bucketCounts to add.

Returns
Type Description
Distribution.Builder

This builder for chaining.

addAllExemplars(Iterable<? extends Distribution.Exemplar> values)

public Distribution.Builder addAllExemplars(Iterable<? extends Distribution.Exemplar> values)

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Parameter
Name Description
values Iterable<? extends com.google.api.Distribution.Exemplar>
Returns
Type Description
Distribution.Builder

addBucketCounts(long value)

public Distribution.Builder addBucketCounts(long value)

The number of values in each bucket of the histogram, as described in bucket_options. If the distribution does not have a histogram, then omit this field. If there is a histogram, then the sum of the values in bucket_counts must equal the value in the count field of the distribution.

If present, bucket_counts should contain N values, where N is the number of buckets specified in bucket_options. If you supply fewer than N values, the remaining values are assumed to be 0.

The order of the values in bucket_counts follows the bucket numbering schemes described for the three bucket types. The first value must be the count for the underflow bucket (number 0). The next N-2 values are the counts for the finite buckets (number 1 through N-2). The N'th value in bucket_counts is the count for the overflow bucket (number N-1).

repeated int64 bucket_counts = 7;

Parameter
Name Description
value long

The bucketCounts to add.

Returns
Type Description
Distribution.Builder

This builder for chaining.

addExemplars(Distribution.Exemplar value)

public Distribution.Builder addExemplars(Distribution.Exemplar value)

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Parameter
Name Description
value Distribution.Exemplar
Returns
Type Description
Distribution.Builder

addExemplars(Distribution.Exemplar.Builder builderForValue)

public Distribution.Builder addExemplars(Distribution.Exemplar.Builder builderForValue)

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Parameter
Name Description
builderForValue Distribution.Exemplar.Builder
Returns
Type Description
Distribution.Builder

addExemplars(int index, Distribution.Exemplar value)

public Distribution.Builder addExemplars(int index, Distribution.Exemplar value)

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Parameters
Name Description
index int
value Distribution.Exemplar
Returns
Type Description
Distribution.Builder

addExemplars(int index, Distribution.Exemplar.Builder builderForValue)

public Distribution.Builder addExemplars(int index, Distribution.Exemplar.Builder builderForValue)

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Parameters
Name Description
index int
builderForValue Distribution.Exemplar.Builder
Returns
Type Description
Distribution.Builder

addExemplarsBuilder()

public Distribution.Exemplar.Builder addExemplarsBuilder()

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Returns
Type Description
Distribution.Exemplar.Builder

addExemplarsBuilder(int index)

public Distribution.Exemplar.Builder addExemplarsBuilder(int index)

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Parameter
Name Description
index int
Returns
Type Description
Distribution.Exemplar.Builder

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public Distribution.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
Name Description
field FieldDescriptor
value Object
Returns
Type Description
Distribution.Builder
Overrides

build()

public Distribution build()
Returns
Type Description
Distribution

buildPartial()

public Distribution buildPartial()
Returns
Type Description
Distribution

clear()

public Distribution.Builder clear()
Returns
Type Description
Distribution.Builder
Overrides

clearBucketCounts()

public Distribution.Builder clearBucketCounts()

The number of values in each bucket of the histogram, as described in bucket_options. If the distribution does not have a histogram, then omit this field. If there is a histogram, then the sum of the values in bucket_counts must equal the value in the count field of the distribution.

If present, bucket_counts should contain N values, where N is the number of buckets specified in bucket_options. If you supply fewer than N values, the remaining values are assumed to be 0.

The order of the values in bucket_counts follows the bucket numbering schemes described for the three bucket types. The first value must be the count for the underflow bucket (number 0). The next N-2 values are the counts for the finite buckets (number 1 through N-2). The N'th value in bucket_counts is the count for the overflow bucket (number N-1).

repeated int64 bucket_counts = 7;

Returns
Type Description
Distribution.Builder

This builder for chaining.

clearBucketOptions()

public Distribution.Builder clearBucketOptions()

Defines the histogram bucket boundaries. If the distribution does not contain a histogram, then omit this field.

.google.api.Distribution.BucketOptions bucket_options = 6;

Returns
Type Description
Distribution.Builder

clearCount()

public Distribution.Builder clearCount()

The number of values in the population. Must be non-negative. This value must equal the sum of the values in bucket_counts if a histogram is provided.

int64 count = 1;

Returns
Type Description
Distribution.Builder

This builder for chaining.

clearExemplars()

public Distribution.Builder clearExemplars()

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Returns
Type Description
Distribution.Builder

clearField(Descriptors.FieldDescriptor field)

public Distribution.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
Name Description
field FieldDescriptor
Returns
Type Description
Distribution.Builder
Overrides

clearMean()

public Distribution.Builder clearMean()

The arithmetic mean of the values in the population. If count is zero then this field must be zero.

double mean = 2;

Returns
Type Description
Distribution.Builder

This builder for chaining.

clearOneof(Descriptors.OneofDescriptor oneof)

public Distribution.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
Name Description
oneof OneofDescriptor
Returns
Type Description
Distribution.Builder
Overrides

clearRange()

public Distribution.Builder clearRange()

If specified, contains the range of the population values. The field must not be present if the count is zero.

.google.api.Distribution.Range range = 4;

Returns
Type Description
Distribution.Builder

clearSumOfSquaredDeviation()

public Distribution.Builder clearSumOfSquaredDeviation()

The sum of squared deviations from the mean of the values in the population. For values x_i this is:

 Sum<a href="(x_i - mean">i=1..n</a>^2)

Knuth, "The Art of Computer Programming", Vol. 2, page 232, 3rd edition describes Welford's method for accumulating this sum in one pass.

If count is zero then this field must be zero.

double sum_of_squared_deviation = 3;

Returns
Type Description
Distribution.Builder

This builder for chaining.

clone()

public Distribution.Builder clone()
Returns
Type Description
Distribution.Builder
Overrides

getBucketCounts(int index)

public long getBucketCounts(int index)

The number of values in each bucket of the histogram, as described in bucket_options. If the distribution does not have a histogram, then omit this field. If there is a histogram, then the sum of the values in bucket_counts must equal the value in the count field of the distribution.

If present, bucket_counts should contain N values, where N is the number of buckets specified in bucket_options. If you supply fewer than N values, the remaining values are assumed to be 0.

The order of the values in bucket_counts follows the bucket numbering schemes described for the three bucket types. The first value must be the count for the underflow bucket (number 0). The next N-2 values are the counts for the finite buckets (number 1 through N-2). The N'th value in bucket_counts is the count for the overflow bucket (number N-1).

repeated int64 bucket_counts = 7;

Parameter
Name Description
index int

The index of the element to return.

Returns
Type Description
long

The bucketCounts at the given index.

getBucketCountsCount()

public int getBucketCountsCount()

The number of values in each bucket of the histogram, as described in bucket_options. If the distribution does not have a histogram, then omit this field. If there is a histogram, then the sum of the values in bucket_counts must equal the value in the count field of the distribution.

If present, bucket_counts should contain N values, where N is the number of buckets specified in bucket_options. If you supply fewer than N values, the remaining values are assumed to be 0.

The order of the values in bucket_counts follows the bucket numbering schemes described for the three bucket types. The first value must be the count for the underflow bucket (number 0). The next N-2 values are the counts for the finite buckets (number 1 through N-2). The N'th value in bucket_counts is the count for the overflow bucket (number N-1).

repeated int64 bucket_counts = 7;

Returns
Type Description
int

The count of bucketCounts.

getBucketCountsList()

public List<Long> getBucketCountsList()

The number of values in each bucket of the histogram, as described in bucket_options. If the distribution does not have a histogram, then omit this field. If there is a histogram, then the sum of the values in bucket_counts must equal the value in the count field of the distribution.

If present, bucket_counts should contain N values, where N is the number of buckets specified in bucket_options. If you supply fewer than N values, the remaining values are assumed to be 0.

The order of the values in bucket_counts follows the bucket numbering schemes described for the three bucket types. The first value must be the count for the underflow bucket (number 0). The next N-2 values are the counts for the finite buckets (number 1 through N-2). The N'th value in bucket_counts is the count for the overflow bucket (number N-1).

repeated int64 bucket_counts = 7;

Returns
Type Description
List<Long>

A list containing the bucketCounts.

getBucketOptions()

public Distribution.BucketOptions getBucketOptions()

Defines the histogram bucket boundaries. If the distribution does not contain a histogram, then omit this field.

.google.api.Distribution.BucketOptions bucket_options = 6;

Returns
Type Description
Distribution.BucketOptions

The bucketOptions.

getBucketOptionsBuilder()

public Distribution.BucketOptions.Builder getBucketOptionsBuilder()

Defines the histogram bucket boundaries. If the distribution does not contain a histogram, then omit this field.

.google.api.Distribution.BucketOptions bucket_options = 6;

Returns
Type Description
Distribution.BucketOptions.Builder

getBucketOptionsOrBuilder()

public Distribution.BucketOptionsOrBuilder getBucketOptionsOrBuilder()

Defines the histogram bucket boundaries. If the distribution does not contain a histogram, then omit this field.

.google.api.Distribution.BucketOptions bucket_options = 6;

Returns
Type Description
Distribution.BucketOptionsOrBuilder

getCount()

public long getCount()

The number of values in the population. Must be non-negative. This value must equal the sum of the values in bucket_counts if a histogram is provided.

int64 count = 1;

Returns
Type Description
long

The count.

getDefaultInstanceForType()

public Distribution getDefaultInstanceForType()
Returns
Type Description
Distribution

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
Type Description
Descriptor
Overrides

getExemplars(int index)

public Distribution.Exemplar getExemplars(int index)

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Parameter
Name Description
index int
Returns
Type Description
Distribution.Exemplar

getExemplarsBuilder(int index)

public Distribution.Exemplar.Builder getExemplarsBuilder(int index)

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Parameter
Name Description
index int
Returns
Type Description
Distribution.Exemplar.Builder

getExemplarsBuilderList()

public List<Distribution.Exemplar.Builder> getExemplarsBuilderList()

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Returns
Type Description
List<Builder>

getExemplarsCount()

public int getExemplarsCount()

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Returns
Type Description
int

getExemplarsList()

public List<Distribution.Exemplar> getExemplarsList()

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Returns
Type Description
List<Exemplar>

getExemplarsOrBuilder(int index)

public Distribution.ExemplarOrBuilder getExemplarsOrBuilder(int index)

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Parameter
Name Description
index int
Returns
Type Description
Distribution.ExemplarOrBuilder

getExemplarsOrBuilderList()

public List<? extends Distribution.ExemplarOrBuilder> getExemplarsOrBuilderList()

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Returns
Type Description
List<? extends com.google.api.Distribution.ExemplarOrBuilder>

getMean()

public double getMean()

The arithmetic mean of the values in the population. If count is zero then this field must be zero.

double mean = 2;

Returns
Type Description
double

The mean.

getRange()

public Distribution.Range getRange()

If specified, contains the range of the population values. The field must not be present if the count is zero.

.google.api.Distribution.Range range = 4;

Returns
Type Description
Distribution.Range

The range.

getRangeBuilder()

public Distribution.Range.Builder getRangeBuilder()

If specified, contains the range of the population values. The field must not be present if the count is zero.

.google.api.Distribution.Range range = 4;

Returns
Type Description
Distribution.Range.Builder

getRangeOrBuilder()

public Distribution.RangeOrBuilder getRangeOrBuilder()

If specified, contains the range of the population values. The field must not be present if the count is zero.

.google.api.Distribution.Range range = 4;

Returns
Type Description
Distribution.RangeOrBuilder

getSumOfSquaredDeviation()

public double getSumOfSquaredDeviation()

The sum of squared deviations from the mean of the values in the population. For values x_i this is:

 Sum<a href="(x_i - mean">i=1..n</a>^2)

Knuth, "The Art of Computer Programming", Vol. 2, page 232, 3rd edition describes Welford's method for accumulating this sum in one pass.

If count is zero then this field must be zero.

double sum_of_squared_deviation = 3;

Returns
Type Description
double

The sumOfSquaredDeviation.

hasBucketOptions()

public boolean hasBucketOptions()

Defines the histogram bucket boundaries. If the distribution does not contain a histogram, then omit this field.

.google.api.Distribution.BucketOptions bucket_options = 6;

Returns
Type Description
boolean

Whether the bucketOptions field is set.

hasRange()

public boolean hasRange()

If specified, contains the range of the population values. The field must not be present if the count is zero.

.google.api.Distribution.Range range = 4;

Returns
Type Description
boolean

Whether the range field is set.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Type Description
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
Type Description
boolean
Overrides

mergeBucketOptions(Distribution.BucketOptions value)

public Distribution.Builder mergeBucketOptions(Distribution.BucketOptions value)

Defines the histogram bucket boundaries. If the distribution does not contain a histogram, then omit this field.

.google.api.Distribution.BucketOptions bucket_options = 6;

Parameter
Name Description
value Distribution.BucketOptions
Returns
Type Description
Distribution.Builder

mergeFrom(Distribution other)

public Distribution.Builder mergeFrom(Distribution other)
Parameter
Name Description
other Distribution
Returns
Type Description
Distribution.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public Distribution.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input CodedInputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
Distribution.Builder
Overrides
Exceptions
Type Description
IOException

mergeFrom(Message other)

public Distribution.Builder mergeFrom(Message other)
Parameter
Name Description
other Message
Returns
Type Description
Distribution.Builder
Overrides

mergeRange(Distribution.Range value)

public Distribution.Builder mergeRange(Distribution.Range value)

If specified, contains the range of the population values. The field must not be present if the count is zero.

.google.api.Distribution.Range range = 4;

Parameter
Name Description
value Distribution.Range
Returns
Type Description
Distribution.Builder

mergeUnknownFields(UnknownFieldSet unknownFields)

public final Distribution.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
Name Description
unknownFields UnknownFieldSet
Returns
Type Description
Distribution.Builder
Overrides

removeExemplars(int index)

public Distribution.Builder removeExemplars(int index)

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Parameter
Name Description
index int
Returns
Type Description
Distribution.Builder

setBucketCounts(int index, long value)

public Distribution.Builder setBucketCounts(int index, long value)

The number of values in each bucket of the histogram, as described in bucket_options. If the distribution does not have a histogram, then omit this field. If there is a histogram, then the sum of the values in bucket_counts must equal the value in the count field of the distribution.

If present, bucket_counts should contain N values, where N is the number of buckets specified in bucket_options. If you supply fewer than N values, the remaining values are assumed to be 0.

The order of the values in bucket_counts follows the bucket numbering schemes described for the three bucket types. The first value must be the count for the underflow bucket (number 0). The next N-2 values are the counts for the finite buckets (number 1 through N-2). The N'th value in bucket_counts is the count for the overflow bucket (number N-1).

repeated int64 bucket_counts = 7;

Parameters
Name Description
index int

The index to set the value at.

value long

The bucketCounts to set.

Returns
Type Description
Distribution.Builder

This builder for chaining.

setBucketOptions(Distribution.BucketOptions value)

public Distribution.Builder setBucketOptions(Distribution.BucketOptions value)

Defines the histogram bucket boundaries. If the distribution does not contain a histogram, then omit this field.

.google.api.Distribution.BucketOptions bucket_options = 6;

Parameter
Name Description
value Distribution.BucketOptions
Returns
Type Description
Distribution.Builder

setBucketOptions(Distribution.BucketOptions.Builder builderForValue)

public Distribution.Builder setBucketOptions(Distribution.BucketOptions.Builder builderForValue)

Defines the histogram bucket boundaries. If the distribution does not contain a histogram, then omit this field.

.google.api.Distribution.BucketOptions bucket_options = 6;

Parameter
Name Description
builderForValue Distribution.BucketOptions.Builder
Returns
Type Description
Distribution.Builder

setCount(long value)

public Distribution.Builder setCount(long value)

The number of values in the population. Must be non-negative. This value must equal the sum of the values in bucket_counts if a histogram is provided.

int64 count = 1;

Parameter
Name Description
value long

The count to set.

Returns
Type Description
Distribution.Builder

This builder for chaining.

setExemplars(int index, Distribution.Exemplar value)

public Distribution.Builder setExemplars(int index, Distribution.Exemplar value)

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Parameters
Name Description
index int
value Distribution.Exemplar
Returns
Type Description
Distribution.Builder

setExemplars(int index, Distribution.Exemplar.Builder builderForValue)

public Distribution.Builder setExemplars(int index, Distribution.Exemplar.Builder builderForValue)

Must be in increasing order of value field.

repeated .google.api.Distribution.Exemplar exemplars = 10;

Parameters
Name Description
index int
builderForValue Distribution.Exemplar.Builder
Returns
Type Description
Distribution.Builder

setField(Descriptors.FieldDescriptor field, Object value)

public Distribution.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
Name Description
field FieldDescriptor
value Object
Returns
Type Description
Distribution.Builder
Overrides

setMean(double value)

public Distribution.Builder setMean(double value)

The arithmetic mean of the values in the population. If count is zero then this field must be zero.

double mean = 2;

Parameter
Name Description
value double

The mean to set.

Returns
Type Description
Distribution.Builder

This builder for chaining.

setRange(Distribution.Range value)

public Distribution.Builder setRange(Distribution.Range value)

If specified, contains the range of the population values. The field must not be present if the count is zero.

.google.api.Distribution.Range range = 4;

Parameter
Name Description
value Distribution.Range
Returns
Type Description
Distribution.Builder

setRange(Distribution.Range.Builder builderForValue)

public Distribution.Builder setRange(Distribution.Range.Builder builderForValue)

If specified, contains the range of the population values. The field must not be present if the count is zero.

.google.api.Distribution.Range range = 4;

Parameter
Name Description
builderForValue Distribution.Range.Builder
Returns
Type Description
Distribution.Builder

setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)

public Distribution.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
Name Description
field FieldDescriptor
index int
value Object
Returns
Type Description
Distribution.Builder
Overrides

setSumOfSquaredDeviation(double value)

public Distribution.Builder setSumOfSquaredDeviation(double value)

The sum of squared deviations from the mean of the values in the population. For values x_i this is:

 Sum<a href="(x_i - mean">i=1..n</a>^2)

Knuth, "The Art of Computer Programming", Vol. 2, page 232, 3rd edition describes Welford's method for accumulating this sum in one pass.

If count is zero then this field must be zero.

double sum_of_squared_deviation = 3;

Parameter
Name Description
value double

The sumOfSquaredDeviation to set.

Returns
Type Description
Distribution.Builder

This builder for chaining.

setUnknownFields(UnknownFieldSet unknownFields)

public final Distribution.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
Name Description
unknownFields UnknownFieldSet
Returns
Type Description
Distribution.Builder
Overrides