Trait halo2_proofs::circuit::Layouter
source · pub trait Layouter<F>where
F: Field,{
type Root: Layouter<F>;
// Required methods
fn assign_region<A, AR, N, NR>(
&mut self,
name: N,
assignment: A
) -> Result<AR, Error>
where A: FnMut(Region<'_, F>) -> Result<AR, Error>,
N: Fn() -> NR,
NR: Into<String>;
fn assign_table<A, N, NR>(
&mut self,
name: N,
assignment: A
) -> Result<(), Error>
where A: FnMut(Table<'_, F>) -> Result<(), Error>,
N: Fn() -> NR,
NR: Into<String>;
fn constrain_instance(
&mut self,
cell: Cell,
column: Column<Instance>,
row: usize
) -> Result<(), Error>;
fn get_challenge(&self, challenge: Challenge) -> Value<F>;
fn get_root(&mut self) -> &mut Self::Root;
fn push_namespace<NR, N>(&mut self, name_fn: N)
where NR: Into<String>,
N: FnOnce() -> NR;
fn pop_namespace(&mut self, gadget_name: Option<String>);
// Provided method
fn namespace<NR, N>(
&mut self,
name_fn: N
) -> NamespacedLayouter<'_, F, Self::Root>
where NR: Into<String>,
N: FnOnce() -> NR { ... }
}
Expand description
A layout strategy within a circuit. The layouter is chip-agnostic and applies its strategy to the context and config it is given.
This abstracts over the circuit assignments, handling row indices etc.
Required Associated Types§
Required Methods§
sourcefn assign_region<A, AR, N, NR>(
&mut self,
name: N,
assignment: A
) -> Result<AR, Error>
fn assign_region<A, AR, N, NR>( &mut self, name: N, assignment: A ) -> Result<AR, Error>
Assign a region of gates to an absolute row number.
Inside the closure, the chip may freely use relative offsets; the Layouter
will
treat these assignments as a single “region” within the circuit. Outside this
closure, the Layouter
is allowed to optimise as it sees fit.
fn assign_region(&mut self, || "region name", |region| {
let config = chip.config();
region.assign_advice(config.a, offset, || { Some(value)});
});
sourcefn assign_table<A, N, NR>(
&mut self,
name: N,
assignment: A
) -> Result<(), Error>
fn assign_table<A, N, NR>( &mut self, name: N, assignment: A ) -> Result<(), Error>
Assign a table region to an absolute row number.
fn assign_table(&mut self, || "table name", |table| {
let config = chip.config();
table.assign_fixed(config.a, offset, || { Some(value)});
});
sourcefn constrain_instance(
&mut self,
cell: Cell,
column: Column<Instance>,
row: usize
) -> Result<(), Error>
fn constrain_instance( &mut self, cell: Cell, column: Column<Instance>, row: usize ) -> Result<(), Error>
Constrains a Cell
to equal an instance column’s row value at an
absolute position.
sourcefn get_challenge(&self, challenge: Challenge) -> Value<F>
fn get_challenge(&self, challenge: Challenge) -> Value<F>
Queries the value of the given challenge.
Returns Value::unknown()
if the current synthesis phase is before the challenge can be queried.
sourcefn get_root(&mut self) -> &mut Self::Root
fn get_root(&mut self) -> &mut Self::Root
Gets the “root” of this assignment, bypassing the namespacing.
Not intended for downstream consumption; use Layouter::namespace
instead.
sourcefn push_namespace<NR, N>(&mut self, name_fn: N)
fn push_namespace<NR, N>(&mut self, name_fn: N)
Creates a new (sub)namespace and enters into it.
Not intended for downstream consumption; use Layouter::namespace
instead.
sourcefn pop_namespace(&mut self, gadget_name: Option<String>)
fn pop_namespace(&mut self, gadget_name: Option<String>)
Exits out of the existing namespace.
Not intended for downstream consumption; use Layouter::namespace
instead.