Skip to content

Editor overview

Pepijn de Vos edited this page Aug 18, 2022 · 10 revisions

image

This is the main editing window, typically accessed by opening a schematic from the library manager. The main drawing area is a grid where devices and wires can be placed. At the top are the available tools. On the left are devices that can be placed, and on the right are the properties of the selected device.

Important: do not forget to add a ground node to your schematic. Without it the simulator will give mysterious errors. A ground node can be placed by pressing g or long-pressing the label/port icon in the left sidebar to reveal the ground and supply port types.

See also: keyboard shortcuts

Editing area

The Mosaic editing area uses a fixed, course grid, which makes it very easy to align elements and avoid accidental errors from things that look connected but aren't.

In the default theme, every element has a backdrop to easily distinguish different types. Passive elements are green, power sources are yellow, subcircuits are grey, N-channel devices are blue, P-channel devices are red, and selected items are purple, with their ports highlighted in red.

image

Wires are made up of straight segments. Selecting a wire segment gives it a dashed line. Double-clicking a wire segment, selects all connected wires. Hovering over a wire gives it an outline, so its endpoints can be easily identified.

When more than two wire ends meet in the same tile, a dot is shown to indicate a connection. When wire midpoints cross each other, no connection is formed, and no dot is shown. When a port or wire is not connected to anything, a dashed red outline is shown.

image

When a device port or wire end meets the midpoint of a wire, the wire is split up in segments. Unstable care must be taken when moving devices, split segments remain split, and could potentially cause unexpected connections when trying to cross over the segment endpoints with another wire.

When a wire is drawn "through" a device, that is, a new wire crossing multiple ports of the same device, the wire is split at the ports, and the middle section removed. This allows quickly hooking up passives by drawing wires through them.

image

By holding down ctrl diagonal wires can be drawn.

Toolbar

image

At the top of the screen is a toolbar, divided in three sections.

Pointer tools

Only one of the following tools can be active at the same time, determining the functionality of the mouse.

  1. Pointer tool [esc], for selecting and dragging elements
  2. Wire tool, for drawing wires
  3. Eraser tool, for deleting elements
  4. Pan tool [space], for panning the view (useful on trackpads and 2-button mice)
  5. Probe tool, for plotting voltages in a connected simulator

Selection tools

These tools act on the selected elements

  1. Spin (counter) clockwise
  2. Flip vertically/horizontally
  3. Delete
  4. Cut/Copy/Paste

Global tools

These tools act on the entire schematic

  1. Zoom in/out
  2. Undo/Redo

Other items

image

The right side of the toolbar shows the following buttons

  1. Open the simulator
  2. Open Jupyter Lab
  3. Open the library manager
  4. Unstable take a snapshot (in the future there will be an UI for managing edit history)
  5. Unstable Theme selector (currently features the default and "classic" theme)

Unstable most likely a hamburger menu will be added to house some of these buttons and other planned functionality

The toolbar also shows a little indicator when data synchronization is in progress, followed by a checkmark that will then fade away.

Devices

image

The toolbar can be used to select items to place visually, as an alternative to the keyboard shortcuts. The selected device is highlighted in dark blue. Devices that have a little arrow can be long-pressed to reveal similar devices grouped under it.

Unstable it will be possible to hide/collapse the device toolbar.

The available devices are

  1. port (label, ground, supply, annotation)
  2. resistor
  3. inductor
  4. capacitor
  5. diode
  6. voltage source (current source)
  7. NMOS (PMOS, NPN, PNP)
  8. subcircuit

Device properties

image

When one or more devices are selected, its properties are shown to the right.

Unstable Currently some basic properties are available per interface, and additional ones can be passed in the "spice" field. Check the ngspice manual for the correct syntax.