DPQuery for queries with a DPQuery numerator and fixed denominator.

Inherits From: SumAggregationDPQuery, DPQuery

If the number of records per round is a public constant R, NormalizedQuery could be used with a sum query as the numerator and R as the denominator to implement an average. Under some sampling schemes, such as Poisson subsampling, the actual number of records in a sample is a private quantity, so we cannot use it directly. Using this class with the expected number of records as the denominator gives an unbiased estimate of the average.

numerator_query A SumAggregationDPQuery for the numerator.
denominator A value for the denominator. May be None if it will be supplied via the set_denominator function before get_noised_result is called.



View source

Implements tensorflow_privacy.DPQuery.accumulate_preprocessed_record.


View source

Accumulates a single record into the sample state.

This is a helper method that simply delegates to preprocess_record and accumulate_preprocessed_record for the common case when both of those functions run on a single device. Typically this will be a simple sum.

params The parameters for the sample. In standard DP-SGD training, the clipping norm for the sample's microbatch gradients (i.e., a maximum norm magnitude to which each gradient is clipped)
sample_state The current sample state. In standard DP-SGD training, the accumulated sum of previous clipped microbatch gradients.
record The record to accumulate. In standard DP-SGD training, the gradient computed for the examples in one microbatch, which may be the gradient for just one example (for size 1 microbatches).

The updated sample state. In standard DP-SGD training, the set of previous microbatch gradients with the addition of the record argument.


View source

Implements tensorflow_privacy.DPQuery.derive_metrics.


View source

Implements tensorflow_privacy.DPQuery.derive_sample_params.


View source

Implements tensorflow_privacy.DPQuery.get_noised_result.


View source

Implements tensorflow_privacy.DPQuery.initial_global_state.


View source

Implements tensorflow_privacy.DPQuery.initial_sample_state.


View source

Implements tensorflow_privacy.DPQuery.merge_sample_states.


View source

Implements tensorflow_privacy.DPQuery.preprocess_record.