lcapy.netlist.Netlist

class lcapy.netlist.Netlist(filename=None, context=None, allow_anon=False, kind='super')

Bases: NetlistOpsMixin, NetlistMixin, NetlistSimplifyMixin

This class handles a generic netlist with multiple sources. During analysis, subnetlists are created for each source kind (dc, ac, transient, etc). Since linearity is assumed, superposition is employed.

Methods

`__init__`([filename, context, allow_anon, kind])
`ac`([omega])	Return netlist for ac components of independent sources for angular frequency omega.
`ac_omega_list`()	Return list of the angular frequencies of the sources in the netlist.
`annotate`(cpts, args, *kwargs)	Annotate a particular component (or list of components) with specified schematic attributes and return new netlist.
`annotate_current`(cpts[, domainvar, flow, pos])
`annotate_currents`([cpts, domainvar, flow, ...])	Annotate specified list of component names cpts with current (or flow).
`annotate_node_voltages`([nodes, domainvar, ...])	Create a new netlist with the node voltages annotated.
`annotate_voltage`(cpts[, domainvar, pos])
`annotate_voltages`([cpts, domainvar, style, ...])	Annotate specified list of component names cpts with voltage.
`apply_test_current_source`(Np[, Nm])	This copies the netlist, kills all the sources, and applies a Dirac delta test current source across the specified nodes.
`apply_test_voltage_source`(Np[, Nm])	This copies the netlist, removes any voltage sources across the specified nodes, kills all the remaining sources, and applies a Dirac delta test voltage source across the specified nodes.
`branch_current_names`()	Return ExprList of branch current names of the form i_cptname for the time-domain and of the form I_cptname othwerwise.
`branch_currents`()	Return ExprList of branch currents.
`branch_voltage_names`()	Return ExprList of branch voltage names of the form v_cptname for the time-domain and of the form V_cptname othwerwise.
`branch_voltages`()	Return ExprList of branch voltages.
`convert_IVP`([t])	Remove switches from netlist and convert to an initial value problem.
`dc`()	Return netlist for dc components of independent sources.
`describe`()	Print a message describing how circuit is solved.
`description`()	Return a message describing how circuit is solved.
`evidence_matrix`()	Return the evidence matrix.
`expand`([depth])	Expand the netlist, replacing complicated components with simpler components.
`get_I`(name[, nowarn])	Current through component (time-domain)
`get_Vd`(Np[, Nm])	Voltage drop between nodes (time-domain)
`get_i`(name)	Time-domain current through component
`get_vd`(Np[, Nm])	Time-domain voltage drop between nodes
`highlight`(cpts[, color])	Highlight a particular component (or list of components) with specified color and return new netlist.
`initialize`(cct[, T])	Set the initial values for this netlist based on the values computed for netlist cct at specified time T.
`laplace`([ics])	Return netlist for Laplace-domain representations of independent source values.
`loop_analysis`()	Perform loop analysis for this netlist.
`matrix_equations`([form, invert])	Return modified nodal analysis equations in matrix form.
`mesh_analysis`()	Perform mesh analysis for this netlist.
`modified_nodal_analysis`()	Perform modified nodal analysis for this netlist.
`nodal_analysis`([node_prefix])	Perform nodal analysis for this netlist.
`noise`()	Return netlist for noise components of independent sources.
`noise_model`([T])	"Create noise model where resistors are converted into a series combination of an ideal resistor and a noise voltage source.
`noisy`(*args[, T])	Return a new circuit with the specified resistors in series with noise voltage sources
`noisy_except`(*args[, T])	Return a new circuit with all but the specified resistors in series with noise voltage sources
`open_circuit`(cpt)	Apply open-circuit in series with component.
`prune`(name)	Prune specified element by name or elements specified in list.
`remove`(name)	Remove specified element by name or elements specified in list.
`remove_node_positions`()	Remove explicit node positions added by lcapy-tk.
`renumber`([node_map])	Renumber nodes using specified node_map.
`replace`(oldname, newname)	Replace component.
`replace_switches`([t, switchnames])	Replace specified switches with open-circuit or short-circuit for time at or after t.
`replace_switches_before`([t, switchnames])	Replace specified switches with open-circuit or short-circuit for time just before t.
`save`(filename)	Save netlist to file.
`select`(kind)	Return new netlist with transform domain kind selected for specified sources in sourcenames.
`short_circuit`(cpt)	Apply short-circuit across component.
`switching_times`([tmax])	Return sorted list of the times that switches activate prior to tmax.
`time`()	Return netlist for time-domain representations of independent source values.
`transient`()	Return netlist for transient components of independent sources.
`transient_time`()	Return netlist for transient components of independent sources in Time-domain.

Attributes

`Idict`	Return dictionary of branch currents for each transform domain
`Vdict`	Return dictionary of node voltages for each transform domain
`cpts`	Return list of component names.
`kinds`	Return list of transform domain kinds required to analyse the netlist.
`params`	Return list of symbols used as arguments in the netlist.
`sim`	Generate simulation object.
`ss`	Generate state-space representation.
`sub`	Return dictionary of subnetlists keyed by transform domain kind.
`subcircuits`	Return dictionary of subnetlists keyed by transform domain kind.
`super_nodes`	Super nodes are nodes linked by voltage sources.
`symbols`	Return dictionary of symbols defined in the netlist.
`undefined_symbols`

property Idict: Return dictionary of branch currents for each transform domain

property Vdict: Return dictionary of node voltages for each transform domain

ac(omega=None)

Return netlist for ac components of independent sources for angular frequency omega. If omega is undefined, the angular frequency omega0 is used.

See also: dc, laplace, transient, noise, time.

ac_omega_list(): Return list of the angular frequencies of the sources in the netlist.

annotate(cpts, *args, **kwargs)

Annotate a particular component (or list of components) with specified schematic attributes and return new netlist.

For example: cct.annotate(‘R1’, color=’blue’) cct.annotate(‘R1’, ‘color=blue, dashed’) cct.annotate((‘U1’, ‘U2’), fill=’blue’)