Files
concrete/docs/user/tutorial/WORKING_WITH_FLOATING_POINTS.md
Benoit Chevallier-Mames 7bf2f09615 feat: remove support for np.invert
remove support for np.invert and propose to the user to use bitwise_xor instead, because of impossibilities with float fusing
closes #658
2021-10-19 10:40:23 +02:00

2.5 KiB

Working With Floating Points

An example

def f(x):
    np.fabs(100 * (2 * np.sin(x) * np.cos(x))).astype(np.uint32) # astype is to go back to integer world

where

  • x = EncryptedScalar(UnsignedInteger(bits))

results in

circuit.run(3) == 27
circuit.run(0) == 0
circuit.run(1) == 90
circuit.run(10) == 91
circuit.run(60) == 58

Supported operations

The following operations are supported in the latest release, and we'll add more operations in the upcoming releases.

List of supported unary functions:

  • absolute
  • arccos
  • arccosh
  • arcsin
  • arcsinh
  • arctan
  • arctanh
  • cbrt
  • ceil
  • cos
  • cosh
  • deg2rad
  • degrees
  • exp
  • exp2
  • expm1
  • fabs
  • floor
  • isfinite
  • isinf
  • isnan
  • log
  • log10
  • log1p
  • log2
  • logical_not
  • negative
  • positive
  • rad2deg
  • radians
  • reciprocal
  • rint
  • sign
  • signbit
  • sin
  • sinh
  • spacing
  • sqrt
  • square
  • tan
  • tanh
  • trunc

List of supported binary functions if one of the two operators is a constant scalar:

  • arctan2
  • bitwise_and
  • bitwise_or
  • bitwise_xor
  • copysign
  • equal
  • float_power
  • floor_divide
  • fmax
  • fmin
  • fmod
  • gcd
  • greater
  • greater_equal
  • heaviside
  • hypot
  • lcm
  • ldexp
  • left_shift
  • less
  • less_equal
  • logaddexp
  • logaddexp2
  • logical_and
  • logical_or
  • logical_xor
  • maximum
  • minimum
  • nextafter
  • not_equal
  • power
  • remainder
  • right_shift
  • true_divide

Limitations

Floating point support in Concrete is very limited for the time being. They can't appear on inputs, or they can't be outputs. However, they can be used in intermediate results. Unfortunately, there are limitations on that front as well.

This biggest one is that, because floating point operations are fused into table lookups with a single unsigned integer input and single unsigned integer output, only univariate portion of code can be replaced with table lookups, which means multivariate portions cannot be compiled.

To give a precise example, 100 - np.fabs(50 * (np.sin(x) + np.sin(y))) cannot be compiled because the floating point part depends on both x and y (i.e., it cannot be rewritten in the form 100 - table[z] for a z that could be computed easily from x and y).

To dive into implementation details, you may refer to Fusing Floating Point Operations document.