Plandroid Help Documentation

The built-in catalog editor is launched from the main Plandroid window with the menu item Tools -> Catalog Editor, and lets you view, edit, and create catalog files that define the parts lists that are shown in the Design -> Parts catalog.

The Parts Catalog Tab
Parts tab

The program catalogs are stored as text in XML format, however you don't need to be familiar with XML as the editor will let you navigate and edit a catalog file directly.

You Build a Catalog from Pre-Made Definitions

Catalog files refer to types of parts that are defined in a Definition file. Most definitions will be stored in a number of external files, which any catalog file can refer to. However, some definitions can instead be local, where the definitions are stored in the same file as the catalog itself. You would normally only use a local definition when the definition is for a part that is specific to that one catalog — normally for any unusual parts that would not be found in any other catalogs.

When you open a catalog file, the file type is indicated with a catalog icon (XML file header) in the file tab. Although it is uncommon to have local definitions, the editor will automatically show any local definitions in a separate tab and indicate them with a definition icon (Definition header). More commonly, a catalog file will only use a range of pre-made standard external definition files that are available for all catalog files to use.

You can open any definition file with the file tab context menu item Open Definition File, or in the catalog editor selecting a part and selection the context menu item Go to Definition will also open the appropriate definition file. You can add a new definition file for one file with the menu item Tools -> Add Local Definitions, or you can in principle also add a new general definition file that is available for all catalogs to refer to, but for most situations you will use one of the pre-made definitions to represent common components. The editor shows different views for definition files and catalog files.

You can open and edit multiple files simultaneously.

Viewing a Catalog in the Editor
Catalog Editor

XML file header Catalog Files

A catalog file contains the data the program requires on every part that can be used in the program from (usually) a single supplier or manufacturer. This information includes what you would expect to see in a printed catalog for each part such as a product code, list price, and probably an image. The catalog file in Plandroid also has additional information for each part, for example its physical size, what to use as a label, its connection sizes, if it is a symbol or if it is drawn when printed, as well as its installation costs. A catalog file is organised in the same hierarchy that you see in the Design -> Parts catalog layout: part TYPES, that contain related SUBTYPES, that in turn contain PARTS, typically in a range of different sizes.

Each catalog also has metadata, including the name and version number of the catalog, information about the manufacturer, and the dates that the catalog is valid for. These properties are accessible from the Catalog Info toolbar button (info button).

Definition header Part Definition Files

A part definition contains the information that Plandroid needs to draw and model a class of components. Each part definition can be used by a large number of similar parts that behave the same way. A part definition specifies the following:

Normally when adding a part to your catalog, you would use one of the existing part definitions from the range already supplied in the various definition files.

For convenience, most definitions are placed in one of the dedicated definition files that come with the program. These files can be referred to, and used, by any catalog. They are broadly categorised by similar types of parts to make finding the definitions you require easier. However, if a set of definitions is only relevant to one particular catalog, they can also be included in a definition section of that parts catalog file.

Both Catalog and Definition Files Must Be Signed

Each catalog and definition file must have a valid digital signature to be usable. A valid signature can only be provided by DelftRed Simulation Technology. The signature authenticates that the file has been checked by for correctness, and guarantees that the catalog data has not been modified in any way since it was signed. If any changes are made to the file since it was signed, the digital signature is rendered invalid. Contact us at info@plandroid.com to request signing of your finished catalog.

Using a Modified Catalog

If you are developing your own catalog or definition file you can still use it with the program before requesting our signing services. Plandroid will still read a catalog which has no signature or an invalid signature if both its expiry date and its release date in the Catalog Info are set to the current day, today.

Using the Editor

To use the editor effectively it is useful to be familiar with the catalog file structure. You can modify or create a catalog by editing a catalog in the editor. You can also use the editor to modify or add part definitions to a definition file, however this is an advanced feature and should normally be used with care, as editing an existing definition will change how that part behaves in all catalogs on your system.