halo2/rustdoc/latest/halo2_proofs/plonk/trait.Circuit.html

43 lines
13 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="This is a trait that circuits provide implementations for so that the backend prover can ask the circuit to synthesize using some given [`ConstraintSystem`] implementation."><meta name="keywords" content="rust, rustlang, rust-lang, Circuit"><title>Circuit in halo2_proofs::plonk - Rust</title><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceSerif4-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../FiraSans-Regular.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../FiraSans-Medium.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceCodePro-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceSerif4-Bold.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceCodePro-Semibold.ttf.woff2"><link rel="stylesheet" type="text/css" href="../../normalize.css"><link rel="stylesheet" type="text/css" href="../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../ayu.css" disabled><link rel="stylesheet" type="text/css" href="../../dark.css" disabled><link rel="stylesheet" type="text/css" href="../../light.css" id="themeStyle"><script id="default-settings" ></script><script src="../../storage.js"></script><script src="../../crates.js"></script><script defer src="../../main.js"></script>
<noscript><link rel="stylesheet" href="../../noscript.css"></noscript><link rel="alternate icon" type="image/png" href="../../favicon-16x16.png"><link rel="alternate icon" type="image/png" href="../../favicon-32x32.png"><link rel="icon" type="image/svg+xml" href="../../favicon.svg"><link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/katex.min.css" integrity="sha384-9eLZqc9ds8eNjO3TmqPeYcDj8n+Qfa4nuSiGYa6DjLNcv9BtN69ZIulL9+8CqC9Y" crossorigin="anonymous">
<script src="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/katex.min.js" integrity="sha384-K3vbOmF2BtaVai+Qk37uypf7VrgBubhQreNQe9aGsz9lB63dIFiQVlJbr92dw2Lx" crossorigin="anonymous"></script>
<script src="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/contrib/auto-render.min.js" integrity="sha384-kmZOZB5ObwgQnS/DuDg6TScgOiWWBiVt0plIRkZCmE6rDZGrEOQeHM5PcHi+nyqe" crossorigin="anonymous"></script>
<script>
document.addEventListener("DOMContentLoaded", function() {
renderMathInElement(document.body, {
delimiters: [
{left: "$$", right: "$$", display: true},
{left: "\\(", right: "\\)", display: false},
{left: "$", right: "$", display: false},
{left: "\\[", right: "\\]", display: true}
]
});
});
</script>
</head><body class="rustdoc trait"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="mobile-topbar"><button class="sidebar-menu-toggle">&#9776;</button><a class="sidebar-logo" href="../../halo2_proofs/index.html"><div class="logo-container"><img class="rust-logo" src="../../rust-logo.svg" alt="logo"></div>
</a><h2 class="location"></h2>
</nav>
<nav class="sidebar"><a class="sidebar-logo" href="../../halo2_proofs/index.html"><div class="logo-container"><img class="rust-logo" src="../../rust-logo.svg" alt="logo"></div>
</a><h2 class="location"><a href="#">Circuit</a></h2><div class="sidebar-elems"><section><div class="block"><h3 class="sidebar-title"><a href="#required-associated-types">Required Associated Types</a></h3><ul><li><a href="#associatedtype.Config">Config</a></li><li><a href="#associatedtype.FloorPlanner">FloorPlanner</a></li></ul></div><div class="block"><h3 class="sidebar-title"><a href="#required-methods">Required Methods</a></h3><ul><li><a href="#tymethod.configure">configure</a></li><li><a href="#tymethod.synthesize">synthesize</a></li><li><a href="#tymethod.without_witnesses">without_witnesses</a></li></ul></div><div class="block"><h3 class="sidebar-title"><a href="#implementors">Implementors</a></h3></div></section><h2 class="location"><a href="index.html">In halo2_proofs::plonk</a></h2><div id="sidebar-vars" data-name="Circuit" data-ty="trait" data-relpath=""></div><script defer src="sidebar-items.js"></script></div></nav><main><div class="width-limiter"><div class="sub-container"><a class="sub-logo-container" href="../../halo2_proofs/index.html"><img class="rust-logo" src="../../rust-logo.svg" alt="logo"></a><nav class="sub"><div class="theme-picker hidden"><button id="theme-picker" aria-label="Pick another theme!" aria-haspopup="menu" title="themes"><img width="22" height="22" alt="Pick another theme!" src="../../brush.svg"></button><div id="theme-choices" role="menu"></div></div><form class="search-form"><div class="search-container"><span></span><input class="search-input" name="search" autocomplete="off" spellcheck="false" placeholder="Click or press S to search, ? for more options…" type="search"><button type="button" id="help-button" title="help">?</button><a id="settings-menu" href="../../settings.html" title="settings"><img width="22" height="22" alt="Change settings" src="../../wheel.svg"></a></div></form></nav></div><section id="main-content" class="content"><div class="main-heading">
<h1 class="fqn"><span class="in-band">Trait <a href="../index.html">halo2_proofs</a>::<wbr><a href="index.html">plonk</a>::<wbr><a class="trait" href="#">Circuit</a><button id="copy-path" onclick="copy_path(this)" title="Copy item path to clipboard"><img src="../../clipboard.svg" width="19" height="18" alt="Copy item path"></button></span></h1><span class="out-of-band"><a class="srclink" href="../../src/halo2_proofs/plonk/circuit.rs.html#423-442">source</a> · <a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">&#x2212;</span>]</a></span></div><div class="docblock item-decl"><pre class="rust trait"><code>pub trait Circuit&lt;F:&nbsp;<a class="trait" href="../arithmetic/trait.Field.html" title="trait halo2_proofs::arithmetic::Field">Field</a>&gt; {
type <a href="#associatedtype.Config" class="associatedtype">Config</a>: <a class="trait" href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>;
type <a href="#associatedtype.FloorPlanner" class="associatedtype">FloorPlanner</a>: <a class="trait" href="trait.FloorPlanner.html" title="trait halo2_proofs::plonk::FloorPlanner">FloorPlanner</a>;
fn <a href="#tymethod.without_witnesses" class="fnname">without_witnesses</a>(&amp;self) -&gt; Self;
<span class="item-spacer"></span> fn <a href="#tymethod.configure" class="fnname">configure</a>(meta: &amp;mut <a class="struct" href="struct.ConstraintSystem.html" title="struct halo2_proofs::plonk::ConstraintSystem">ConstraintSystem</a>&lt;F&gt;) -&gt; Self::<a class="associatedtype" href="trait.Circuit.html#associatedtype.Config" title="type halo2_proofs::plonk::Circuit::Config">Config</a>;
<span class="item-spacer"></span> fn <a href="#tymethod.synthesize" class="fnname">synthesize</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&amp;self, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;config: Self::<a class="associatedtype" href="trait.Circuit.html#associatedtype.Config" title="type halo2_proofs::plonk::Circuit::Config">Config</a>, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;layouter: impl <a class="trait" href="../circuit/trait.Layouter.html" title="trait halo2_proofs::circuit::Layouter">Layouter</a>&lt;F&gt;<br>&nbsp;&nbsp;&nbsp;&nbsp;) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.unit.html">()</a>, <a class="enum" href="enum.Error.html" title="enum halo2_proofs::plonk::Error">Error</a>&gt;;
}</code></pre></div><details class="rustdoc-toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>This is a trait that circuits provide implementations for so that the
backend prover can ask the circuit to synthesize using some given
<a href="struct.ConstraintSystem.html" title="ConstraintSystem"><code>ConstraintSystem</code></a> implementation.</p>
</div></details><h2 id="required-associated-types" class="small-section-header">Required Associated Types<a href="#required-associated-types" class="anchor"></a></h2><div class="methods"><details class="rustdoc-toggle" open><summary><div id="associatedtype.Config" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/halo2_proofs/plonk/circuit.rs.html#425">source</a></div><h4 class="code-header">type <a href="#associatedtype.Config" class="associatedtype">Config</a>: <a class="trait" href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a></h4></div></summary><div class="docblock"><p>This is a configuration object that stores things like columns.</p>
</div></details><details class="rustdoc-toggle" open><summary><div id="associatedtype.FloorPlanner" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/halo2_proofs/plonk/circuit.rs.html#428">source</a></div><h4 class="code-header">type <a href="#associatedtype.FloorPlanner" class="associatedtype">FloorPlanner</a>: <a class="trait" href="trait.FloorPlanner.html" title="trait halo2_proofs::plonk::FloorPlanner">FloorPlanner</a></h4></div></summary><div class="docblock"><p>The floor planner used for this circuit. This is an associated type of the
<code>Circuit</code> trait because its behaviour is circuit-critical.</p>
</div></details></div><h2 id="required-methods" class="small-section-header">Required Methods<a href="#required-methods" class="anchor"></a></h2><div class="methods"><details class="rustdoc-toggle" open><summary><div id="tymethod.without_witnesses" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/halo2_proofs/plonk/circuit.rs.html#432">source</a></div><h4 class="code-header">fn <a href="#tymethod.without_witnesses" class="fnname">without_witnesses</a>(&amp;self) -&gt; Self</h4></div></summary><div class="docblock"><p>Returns a copy of this circuit with no witness values (i.e. all witnesses set to
<code>None</code>). For most circuits, this will be equal to <code>Self::default()</code>.</p>
</div></details><details class="rustdoc-toggle" open><summary><div id="tymethod.configure" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/halo2_proofs/plonk/circuit.rs.html#436">source</a></div><h4 class="code-header">fn <a href="#tymethod.configure" class="fnname">configure</a>(meta: &amp;mut <a class="struct" href="struct.ConstraintSystem.html" title="struct halo2_proofs::plonk::ConstraintSystem">ConstraintSystem</a>&lt;F&gt;) -&gt; Self::<a class="associatedtype" href="trait.Circuit.html#associatedtype.Config" title="type halo2_proofs::plonk::Circuit::Config">Config</a></h4></div></summary><div class="docblock"><p>The circuit is given an opportunity to describe the exact gate
arrangement, column arrangement, etc.</p>
</div></details><details class="rustdoc-toggle" open><summary><div id="tymethod.synthesize" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/halo2_proofs/plonk/circuit.rs.html#441">source</a></div><h4 class="code-header">fn <a href="#tymethod.synthesize" class="fnname">synthesize</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&amp;self, <br>&nbsp;&nbsp;&nbsp;&nbsp;config: Self::<a class="associatedtype" href="trait.Circuit.html#associatedtype.Config" title="type halo2_proofs::plonk::Circuit::Config">Config</a>, <br>&nbsp;&nbsp;&nbsp;&nbsp;layouter: impl <a class="trait" href="../circuit/trait.Layouter.html" title="trait halo2_proofs::circuit::Layouter">Layouter</a>&lt;F&gt;<br>) -&gt; <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.unit.html">()</a>, <a class="enum" href="enum.Error.html" title="enum halo2_proofs::plonk::Error">Error</a>&gt;</h4></div></summary><div class="docblock"><p>Given the provided <code>cs</code>, synthesize the circuit. The concrete type of
the caller will be different depending on the context, and they may or
may not expect to have a witness present.</p>
</div></details></div><h2 id="implementors" class="small-section-header">Implementors<a href="#implementors" class="anchor"></a></h2><div class="item-list" id="implementors-list"></div><script type="text/javascript" src="../../implementors/halo2_proofs/plonk/trait.Circuit.js" async></script></section><section id="search" class="content hidden"></section></div></main><div id="rustdoc-vars" data-root-path="../../" data-current-crate="halo2_proofs" data-themes="ayu,dark,light" data-resource-suffix="" data-rustdoc-version="1.62.0-nightly (7c4b47696 2022-04-30)" ></div>
</body></html>