com.google.api

Class Distribution

java.lang.Object

com.google.protobuf.AbstractMessageLite

com.google.protobuf.AbstractMessage

com.google.protobuf.GeneratedMessageV3

com.google.api.Distribution

All Implemented Interfaces:

DistributionOrBuilder, com.google.protobuf.Message, com.google.protobuf.MessageLite, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, java.io.Serializable

public final class Distribution
extends com.google.protobuf.GeneratedMessageV3
implements DistributionOrBuilder

 Distribution contains summary statistics for a population of values and,
 optionally, a histogram representing the distribution of those values across
 a specified set of histogram 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 specifying parameters for a method of computing them
 (buckets of fixed width or buckets of exponentially increasing width).
 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

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Distribution.BucketOptions A Distribution may optionally contain a histogram of the values in the population.
static interface	Distribution.BucketOptionsOrBuilder
static class	Distribution.Builder Distribution contains summary statistics for a population of values and, optionally, a histogram representing the distribution of those values across a specified set of histogram buckets.
static class	Distribution.Range The range of the population values.
static interface	Distribution.RangeOrBuilder

Nested classes/interfaces inherited from class com.google.protobuf.GeneratedMessageV3

com.google.protobuf.GeneratedMessageV3.BuilderParent, com.google.protobuf.GeneratedMessageV3.ExtendableBuilder<MessageType extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage,BuilderType extends com.google.protobuf.GeneratedMessageV3.ExtendableBuilder<MessageType,BuilderType>>, com.google.protobuf.GeneratedMessageV3.ExtendableMessage<MessageType extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage>, com.google.protobuf.GeneratedMessageV3.ExtendableMessageOrBuilder<MessageType extends com.google.protobuf.GeneratedMessageV3.ExtendableMessage>, com.google.protobuf.GeneratedMessageV3.FieldAccessorTable

Field Summary

Fields

Modifier and Type	Field and Description
static int	BUCKET_COUNTS_FIELD_NUMBER
static int	BUCKET_OPTIONS_FIELD_NUMBER
static int	COUNT_FIELD_NUMBER
static int	MEAN_FIELD_NUMBER
static int	RANGE_FIELD_NUMBER
static int	SUM_OF_SQUARED_DEVIATION_FIELD_NUMBER

Fields inherited from class com.google.protobuf.GeneratedMessageV3

alwaysUseFieldBuilders, unknownFields

Fields inherited from class com.google.protobuf.AbstractMessage

memoizedSize

Fields inherited from class com.google.protobuf.AbstractMessageLite

memoizedHashCode

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj)
long	getBucketCounts(int index) If `bucket_options` is given, then the sum of the values in `bucket_counts` must equal the value in `count`.
int	getBucketCountsCount() If `bucket_options` is given, then the sum of the values in `bucket_counts` must equal the value in `count`.
java.util.List<java.lang.Long>	getBucketCountsList() If `bucket_options` is given, then the sum of the values in `bucket_counts` must equal the value in `count`.
Distribution.BucketOptions	getBucketOptions() Defines the histogram bucket boundaries.
Distribution.BucketOptionsOrBuilder	getBucketOptionsOrBuilder() Defines the histogram bucket boundaries.
long	getCount() The number of values in the population.
static Distribution	getDefaultInstance()
Distribution	getDefaultInstanceForType()
static com.google.protobuf.Descriptors.Descriptor	getDescriptor()
double	getMean() The arithmetic mean of the values in the population.
com.google.protobuf.Parser<Distribution>	getParserForType()
Distribution.Range	getRange() If specified, contains the range of the population values.
Distribution.RangeOrBuilder	getRangeOrBuilder() If specified, contains the range of the population values.
int	getSerializedSize()
double	getSumOfSquaredDeviation() The sum of squared deviations from the mean of the values in the population.
com.google.protobuf.UnknownFieldSet	getUnknownFields()
boolean	hasBucketOptions() Defines the histogram bucket boundaries.
int	hashCode()
boolean	hasRange() If specified, contains the range of the population values.
protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable	internalGetFieldAccessorTable()
boolean	isInitialized()
static Distribution.Builder	newBuilder()
static Distribution.Builder	newBuilder(Distribution prototype)
Distribution.Builder	newBuilderForType()
protected Distribution.Builder	newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent)
static Distribution	parseDelimitedFrom(java.io.InputStream input)
static Distribution	parseDelimitedFrom(java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
static Distribution	parseFrom(byte[] data)
static Distribution	parseFrom(byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
static Distribution	parseFrom(com.google.protobuf.ByteString data)
static Distribution	parseFrom(com.google.protobuf.ByteString data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
static Distribution	parseFrom(com.google.protobuf.CodedInputStream input)
static Distribution	parseFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
static Distribution	parseFrom(java.io.InputStream input)
static Distribution	parseFrom(java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
static com.google.protobuf.Parser<Distribution>	parser()
Distribution.Builder	toBuilder()
void	writeTo(com.google.protobuf.CodedOutputStream output)

Methods inherited from class com.google.protobuf.GeneratedMessageV3

computeStringSize, computeStringSizeNoTag, getAllFields, getDescriptorForType, getField, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, hasField, hasOneof, internalGetMapField, makeExtensionsImmutable, newBuilderForType, parseDelimitedWithIOException, parseDelimitedWithIOException, parseUnknownField, parseWithIOException, parseWithIOException, parseWithIOException, parseWithIOException, writeReplace, writeString, writeStringNoTag

Methods inherited from class com.google.protobuf.AbstractMessage

findInitializationErrors, getInitializationErrorString, hashBoolean, hashEnum, hashEnumList, hashFields, hashLong, toString

Methods inherited from class com.google.protobuf.AbstractMessageLite

addAll, checkByteStringIsUtf8, toByteArray, toByteString, writeDelimitedTo, writeTo

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.google.protobuf.MessageOrBuilder

findInitializationErrors, getAllFields, getDescriptorForType, getField, getInitializationErrorString, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, hasField, hasOneof

Methods inherited from interface com.google.protobuf.MessageLite

toByteArray, toByteString, writeDelimitedTo, writeTo

Field Detail

COUNT_FIELD_NUMBER

public static final int COUNT_FIELD_NUMBER

See Also:

Constant Field Values

MEAN_FIELD_NUMBER

public static final int MEAN_FIELD_NUMBER

See Also:

Constant Field Values

SUM_OF_SQUARED_DEVIATION_FIELD_NUMBER

public static final int SUM_OF_SQUARED_DEVIATION_FIELD_NUMBER

See Also:

Constant Field Values

RANGE_FIELD_NUMBER

public static final int RANGE_FIELD_NUMBER

See Also:

Constant Field Values

BUCKET_OPTIONS_FIELD_NUMBER

public static final int BUCKET_OPTIONS_FIELD_NUMBER

See Also:

Constant Field Values

BUCKET_COUNTS_FIELD_NUMBER

public static final int BUCKET_COUNTS_FIELD_NUMBER

See Also:

Constant Field Values

Method Detail

getUnknownFields

public final com.google.protobuf.UnknownFieldSet getUnknownFields()

Specified by:

getUnknownFields in interface com.google.protobuf.MessageOrBuilder

Overrides:

getUnknownFields in class com.google.protobuf.GeneratedMessageV3

getDescriptor

public static final com.google.protobuf.Descriptors.Descriptor getDescriptor()

internalGetFieldAccessorTable

protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()

Specified by:

internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessageV3

getCount

public long getCount()

 The number of values in the population. Must be non-negative.
 

optional int64 count = 1;

Specified by:

getCount in interface DistributionOrBuilder

getMean

public double getMean()

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

optional double mean = 2;

Specified by:

getMean in interface DistributionOrBuilder

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[i=1..n]((x_i - mean)^2)
 Knuth, "The Art of Computer Programming", Vol. 2, page 323, 3rd edition
 describes Welford's method for accumulating this sum in one pass.
 If `count` is zero then this field must be zero.
 

optional double sum_of_squared_deviation = 3;

Specified by:

getSumOfSquaredDeviation in interface DistributionOrBuilder

hasRange

public boolean hasRange()

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

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

Specified by:

hasRange in interface DistributionOrBuilder

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.
 

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

Specified by:

getRange in interface DistributionOrBuilder

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.
 

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

Specified by:

getRangeOrBuilder in interface DistributionOrBuilder

hasBucketOptions

public boolean hasBucketOptions()

 Defines the histogram bucket boundaries.
 

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

Specified by:

hasBucketOptions in interface DistributionOrBuilder

getBucketOptions

public Distribution.BucketOptions getBucketOptions()

 Defines the histogram bucket boundaries.
 

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

Specified by:

getBucketOptions in interface DistributionOrBuilder

getBucketOptionsOrBuilder

public Distribution.BucketOptionsOrBuilder getBucketOptionsOrBuilder()

 Defines the histogram bucket boundaries.
 

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

Specified by:

getBucketOptionsOrBuilder in interface DistributionOrBuilder

getBucketCountsList

public java.util.List<java.lang.Long> getBucketCountsList()

 If `bucket_options` is given, then the sum of the values in `bucket_counts`
 must equal the value in `count`.  If `bucket_options` is not given, no
 `bucket_counts` fields may be given.
 Bucket counts are given in order under the numbering scheme described
 above (the underflow bucket has number 0; the finite buckets, if any,
 have numbers 1 through N-2; the overflow bucket has number N-1).
 The size of `bucket_counts` must be no greater than N as defined in
 `bucket_options`.
 Any suffix of trailing zero bucket_count fields may be omitted.
 

repeated int64 bucket_counts = 7;

Specified by:

getBucketCountsList in interface DistributionOrBuilder

getBucketCountsCount

public int getBucketCountsCount()

 If `bucket_options` is given, then the sum of the values in `bucket_counts`
 must equal the value in `count`.  If `bucket_options` is not given, no
 `bucket_counts` fields may be given.
 Bucket counts are given in order under the numbering scheme described
 above (the underflow bucket has number 0; the finite buckets, if any,
 have numbers 1 through N-2; the overflow bucket has number N-1).
 The size of `bucket_counts` must be no greater than N as defined in
 `bucket_options`.
 Any suffix of trailing zero bucket_count fields may be omitted.
 

repeated int64 bucket_counts = 7;

Specified by:

getBucketCountsCount in interface DistributionOrBuilder

getBucketCounts

public long getBucketCounts(int index)

 If `bucket_options` is given, then the sum of the values in `bucket_counts`
 must equal the value in `count`.  If `bucket_options` is not given, no
 `bucket_counts` fields may be given.
 Bucket counts are given in order under the numbering scheme described
 above (the underflow bucket has number 0; the finite buckets, if any,
 have numbers 1 through N-2; the overflow bucket has number N-1).
 The size of `bucket_counts` must be no greater than N as defined in
 `bucket_options`.
 Any suffix of trailing zero bucket_count fields may be omitted.
 

repeated int64 bucket_counts = 7;

Specified by:

getBucketCounts in interface DistributionOrBuilder

isInitialized

public final boolean isInitialized()

Specified by:

isInitialized in interface com.google.protobuf.MessageLiteOrBuilder

Overrides:

isInitialized in class com.google.protobuf.GeneratedMessageV3

writeTo

public void writeTo(com.google.protobuf.CodedOutputStream output)
             throws java.io.IOException

Specified by:

writeTo in interface com.google.protobuf.MessageLite

Overrides:

writeTo in class com.google.protobuf.GeneratedMessageV3

Throws:

java.io.IOException

getSerializedSize

public int getSerializedSize()

Specified by:

getSerializedSize in interface com.google.protobuf.MessageLite

Overrides:

getSerializedSize in class com.google.protobuf.GeneratedMessageV3

equals

public boolean equals(java.lang.Object obj)

Specified by:

equals in interface com.google.protobuf.Message

Overrides:

equals in class com.google.protobuf.AbstractMessage

hashCode

public int hashCode()

Specified by:

hashCode in interface com.google.protobuf.Message

Overrides:

hashCode in class com.google.protobuf.AbstractMessage

parseFrom

public static Distribution parseFrom(com.google.protobuf.ByteString data)
                              throws com.google.protobuf.InvalidProtocolBufferException

Throws:

com.google.protobuf.InvalidProtocolBufferException

parseFrom

public static Distribution parseFrom(com.google.protobuf.ByteString data,
                                     com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                              throws com.google.protobuf.InvalidProtocolBufferException

Throws:

com.google.protobuf.InvalidProtocolBufferException

parseFrom

public static Distribution parseFrom(byte[] data)
                              throws com.google.protobuf.InvalidProtocolBufferException

Throws:

com.google.protobuf.InvalidProtocolBufferException

parseFrom

public static Distribution parseFrom(byte[] data,
                                     com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                              throws com.google.protobuf.InvalidProtocolBufferException

Throws:

com.google.protobuf.InvalidProtocolBufferException

parseFrom

public static Distribution parseFrom(java.io.InputStream input)
                              throws java.io.IOException

Throws:

java.io.IOException

parseFrom

public static Distribution parseFrom(java.io.InputStream input,
                                     com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                              throws java.io.IOException

Throws:

java.io.IOException

parseDelimitedFrom

public static Distribution parseDelimitedFrom(java.io.InputStream input)
                                       throws java.io.IOException

Throws:

java.io.IOException

parseDelimitedFrom

public static Distribution parseDelimitedFrom(java.io.InputStream input,
                                              com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                       throws java.io.IOException

Throws:

java.io.IOException

parseFrom

public static Distribution parseFrom(com.google.protobuf.CodedInputStream input)
                              throws java.io.IOException

Throws:

java.io.IOException

parseFrom

public static Distribution parseFrom(com.google.protobuf.CodedInputStream input,
                                     com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                              throws java.io.IOException

Throws:

java.io.IOException

newBuilderForType

public Distribution.Builder newBuilderForType()

Specified by:

newBuilderForType in interface com.google.protobuf.Message

Specified by:

newBuilderForType in interface com.google.protobuf.MessageLite

newBuilder

public static Distribution.Builder newBuilder()

newBuilder

public static Distribution.Builder newBuilder(Distribution prototype)

toBuilder

public Distribution.Builder toBuilder()

Specified by:

toBuilder in interface com.google.protobuf.Message

Specified by:

toBuilder in interface com.google.protobuf.MessageLite

newBuilderForType

protected Distribution.Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent)

Specified by:

newBuilderForType in class com.google.protobuf.GeneratedMessageV3

getDefaultInstance

public static Distribution getDefaultInstance()

parser

public static com.google.protobuf.Parser<Distribution> parser()

getParserForType

public com.google.protobuf.Parser<Distribution> getParserForType()

Specified by:

getParserForType in interface com.google.protobuf.Message

Specified by:

getParserForType in interface com.google.protobuf.MessageLite

Overrides:

getParserForType in class com.google.protobuf.GeneratedMessageV3

getDefaultInstanceForType

public Distribution getDefaultInstanceForType()

Specified by:

getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuilder

Specified by:

getDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilder