what's that gerber?

[![latest][whats-that-gerber-latest-badge]][npm]
[![next][whats-that-gerber-next-badge]][npm-next]
[![david][whats-that-gerber-david-badge]][david]

> Identify Gerber and drill files by filename

Have you got a bunch of Gerber files lying around without any idea what they're for? We've all been there. whats-that-gerber is here to help.

Part of the [tracespace][] collection of PCB visualization tools.

[tracespace]: https://github.com/tracespace/tracespace
[npm]: https://www.npmjs.com/package/whats-that-gerber
[npm-next]: https://www.npmjs.com/package/whats-that-gerber/v/next
[david]: https://david-dm.org/tracespace/tracespace?path=packages/whats-that-gerber
[whats-that-gerber-latest-badge]: https://flat.badgen.net/npm/v/whats-that-gerber
[whats-that-gerber-next-badge]: https://flat.badgen.net/npm/v/whats-that-gerber/next
[whats-that-gerber-david-badge]: https://flat.badgen.net/david/dep/tracespace/tracespace/packages/whats-that-gerber

install

``shell
npm install --save whats-that-gerber


or


yarn add whats-that-gerber
`

Or, use a script tag:

`html


`

usage

Pass whatsThatGerber an array of filenames from a PCB, and it will give you back an object keyed by filename with the best guess it can make for the type and side of each file. If both side and type are null, the filename cannot be identified as a Gerber / drill file.

`js
const whatsThatGerber = require('whats-that-gerber')

const filenames = ['my-board-F_Cu.gbr', 'my-board-B_Cu.gbr', 'foo.bar']
const typeByFilename = whatsThatGerber(filenames)
// {
// 'my-board-F_Cu.gbr': {type: 'copper', side: 'top'},
// 'my-board-B_Cu.gbr': {type: 'copper', side: 'bottom'},
// 'my-board-notes.gbr': {type: 'drawing', side: null},
// 'foo.bar': {type: null, side: null},
// }
`

$3

There are 12 available layer types, were a type is an object of the format:

`js
{
side: 'top' | 'bottom' | 'inner' | 'all' | null,
type: 'copper' | 'soldermask' | 'silkscreen' | 'solderpaste' | 'drill' | 'outline' | 'drawing' | null,
}
`

You can get an array of all types with:

`js
const {getAllLayers} = require('whats-that-gerber')
const allLayers = getAllLayers()
`

| side | type |
| ---------- | --------------- |
| 'top' | 'copper' |
| 'top' | 'soldermask' |
| 'top' | 'silkscreen' |
| 'top' | 'solderpaste' |
| 'bottom' | 'copper' |
| 'bottom' | 'soldermask' |
| 'bottom' | 'silkscreen' |
| 'bottom' | 'solderpaste' |
| 'inner' | 'copper' |
| 'all' | 'outline' |
| 'all' | 'drill' |
| null | 'drawing' |

#### constants

Side and type constants are exported for your usage:

`js
const {
// layer types
TYPE_COPPER, // 'copper'
TYPE_SOLDERMASK, // 'soldermask'
TYPE_SILKSCREEN, // 'silkscreen'
TYPE_SOLDERPASTE, // 'solderpaste'
TYPE_DRILL, // 'drill'
TYPE_OUTLINE, // 'outline'
TYPE_DRAWING, // 'drawing'

// board sides
SIDE_TOP, // 'top'
SIDE_BOTTOM, // 'bottom'
SIDE_INNER, // 'inner'
SIDE_ALL, // 'all'
} = require('whats-that-gerber')
`

#### checking if a layer type is valid

You can check if any given string is a valid layer type with:

`js
const {validate} = require('whats-that-gerber')

const type1 = {side: 'top', type: 'copper'}
const type2 = {side: 'foo', type: 'silkscreen'}
const type3 = {side: 'bottom', type: 'bar'}

console.log(validate(type1)) // {valid: true, side: 'top', type: 'copper'}
console.log(validate(type2)) // {valid: false, side: null, type: 'silkscreen'}
console.log(validate(type3)) // {valid: false, side: 'bottom', type: null}
`

$3

We should be able to identify files output by the following programs:

- KiCad
- Eagle
- Altium
- Orcad
- gEDA PCB
- DipTrace

contributing

Please read the Contributing Section of the main README for development setup instructions.

If you're adding or modifying a filetype matcher, please remember to add or modify an example filename in @tracespace/fixtures/gerber-filenames.json` to ensure your change is tested.