Module Hardcaml__.Signal_graph
val sexp_of_t : t -> Ppx_sexp_conv_lib.Sexp.t
val create : Hardcaml.Signal.t Hardcaml__.Import.list -> t
Create a
Signal_graph.t
from a list of signals (commonly, circuit outputs).
val inputs : t -> Hardcaml.Signal.t Hardcaml__.Import.list Hardcaml__.Import.Or_error.t
Traverse the graph and find all inputs. Badly formed inputs (no name, or multiple names) return an error.
val outputs : ?validate:Hardcaml__.Import.bool -> t -> Hardcaml.Signal.t Hardcaml__.Import.list Hardcaml__.Import.Or_error.t
Return the outputs of the signal graph. If
validate
istrue
, then the outputs are checked for compatibility with circuit outputs.
val depth_first_search : ?deps:(Hardcaml.Signal.t -> Hardcaml.Signal.t Hardcaml__.Import.list) -> ?f_before:('a -> Hardcaml.Signal.t -> 'a) -> ?f_after:('a -> Hardcaml.Signal.t -> 'a) -> t -> init:'a -> 'a
Visit all signals in the graph, starting at the outputs, in a depth-first manner. Each signal is visited only once.
f_before
is called before recursing on each signal's fan-in. Similiarly,f_after
is called after recursing on the fan-in.If
deps
is provided it will be used to compute signal dependencies rather than the default definition. This is useful for terminating traversals based on some condition on signals, e.g., if it's a register or a memory.
val fold : t -> init:'a -> f:('a -> Hardcaml.Signal.t -> 'a) -> 'a
Fold across all signals in the graph, starting at the outputs. Each signal is visited only once.
val filter : t -> f:(Hardcaml.Signal.t -> Hardcaml__.Import.bool) -> Hardcaml.Signal.t Hardcaml__.Import.list
Return a list of all signals in the graph for whom
f signal
returns true.
val iter : t -> f:(Hardcaml.Signal.t -> Hardcaml__.Import.unit) -> Hardcaml__.Import.unit
Iterate over all signals in the graph.
val detect_combinational_loops : t -> Hardcaml__.Import.unit Hardcaml__.Import.Or_error.t
Retuns an error if the graph has a combinational loop, that is, a path from a signal back to itself that doesn't pass though a register, memory or instantiation.
val normalize_uids : t -> t
normalize_uids t
creates a copy oft
that is identical tot
except the uids are numbered starting at 1.
val fan_out_map : ?deps:(Hardcaml.Signal.t -> Hardcaml.Signal.t Hardcaml__.Import.list) -> t -> Hardcaml.Signal.Uid_set.t Hardcaml.Signal.Uid_map.t
Fan-out of each signal in the signal graph. The fan-out of a signal is the set of signals it drives.
val fan_in_map : ?deps:(Hardcaml.Signal.t -> Hardcaml.Signal.t Hardcaml__.Import.list) -> t -> Hardcaml.Signal.Uid_set.t Hardcaml.Signal.Uid_map.t
Fan-in of each signal in the signal graph. The fan-in of a signal is the set of signals that drive it.
val topological_sort : ?deps:(Hardcaml.Signal.t -> Hardcaml.Signal.t Hardcaml__.Import.list) -> t -> Hardcaml.Signal.t Hardcaml__.Import.list
topological_sort t
sorts the signals int
so that all the signals indeps s
occur befores
.
val scheduling_deps : Hardcaml.Signal.t -> Hardcaml.Signal.t Hardcaml__.Import.list
Signal dependencies used for scheduling. Breaks loops through sequential elements like registers and memories.
val last_layer_of_nodes : is_input:(Hardcaml.Signal.t -> Hardcaml__.Import.bool) -> t -> Hardcaml.Signal.Uid.t Hardcaml__.Import.List.t
Final layer of combinational nodes which sit on the path between the outputs and any driving register or memory.