concrete/docs/user/howto/PRINTING_AND_DRAWING.md

FIXME(all): should we update to the new API or have it for both?

Printing and Drawing

Sometimes, it can be useful to print or draw fhe circuits, we provide methods to just do that. Please read Compiling and Executing before reading further to see how you can compile your function into an fhe circuit.

Printing

To print your circuit, you can do the following:

print(circuit)

Drawing

To draw your circuit, you can do the following:

drawing = circuit.draw()

This method will draw the circuit on a temporary PNG file and return the path to this file.

To show the drawing, you can use the following code in a jupyter notebook.

from PIL import Image
drawing = Image.open(circuit.draw())
drawing.show()
drawing.close()

Additionally, you can use the show option of the draw method to show the drawing with matplotlib. Beware that this will clear the matplotlib plots you have.

circuit.draw(show=True)

Lastly, you can save the drawing to a specific path like this:

destination = "/tmp/path/of/your/choice.png"
drawing = circuit.draw(save_to=destination)
assert drawing == destination