Skip to content
OpenCDD

Run your own

The full dictionary was never a download away. It was an export away.

IEC publishes the Common Data Dictionary and licenses its full use inside your organization. This guide takes you from cdd.iec.ch to a locally-running OpenCDD browsing the complete data — every attribute this site's public demo filters out, licensed to you by IEC.

§ Why this way

The IEC CDD License Agreement is precise about what may be redistributed: the § 5 FREE ATTRIBUTES, and the IEC 62720 units dictionary in its entirety (see our compliance matrix). Everything else — definitions, remarks, version history, the lot — is licensed to you for use inside your organization (§ 8), but not to us for republishing.

So we don't republish it. Instead: you export the dictionaries from IEC directly, and OpenCDD converts them into a working local dictionary in one command. You get the full data, under the license IEC granted you, and OpenCDD stays a clean-room engine.

§ Step 1 — Accept the license at cdd.iec.ch

Open the CDD and accept the terms.

Go to cdd.iec.chand accept the license agreement when prompted. That agreement — the same one this site follows to the letter — is what licenses your internal use of the full content (§ 8). No account is needed for the public dictionaries.

§ Step 2 — Search for everything, per kind

One search per entity kind, * matches all.

Open the CDD search, click Search, pick an entity kind, enter * in the term field, and click Export selected. Repeat once per kind:

  • Classes
  • Properties
  • Value lists
  • Value terms
  • Units
  • Relations
  • Lists of units
  • DET classification

Each export arrives as a zip of per-kind Excel files — the IEC 62656-1 Parcel format that OpenCDD reads natively.

§ Step 3 — Convert with the opencdd gem

One command turns the export into an OpenCDD dictionary.

You need Ruby 3.1+. Install the gem, save the script, run it:

gem install opencdd
# convert.rb — IEC CDD export -> OpenCDD dictionary
#   ruby convert.rb "<unzipped export dir or single file>" <slug>
require "opencdd"

source, slug = ARGV[0], ARGV[1]
abort "usage: ruby convert.rb <source> <slug>" unless source && slug

db = Opencdd::Database.load(source)
Dir.mkdir(slug) unless Dir.exist?(slug)
File.write(
  File.join(slug, "database.json"),
  Opencdd::Exporters::Json.new.to_json(db),
)
puts "Wrote #{slug}/database.json (#{db.classes.size} classes)"
ruby convert.rb "export_CDD_IEC61360 in EXCEL format" iec61360

The converter accepts every layout the gem reads: the per-kind Excel export folder, a single exported .xls, a ParcelMaker workbook, or a sharded per-class directory. AddOpencdd::Cddal.serialize(db)if you also want the plain-text CDDAL form.

§ Step 4 — Run OpenCDD on your dictionary

Drop it into the browser and go.

Clone the browser, copy your converted dictionary into its data directory, and register it in the catalog:

git clone https://github.com/opencdd/opencdd.github.io
cd opencdd.github.io
cp -r iec61360 src/content/data/

Add an entry for your dictionary to src/content/data/index.json:

{
  "slug": "iec61360",
  "parcelId": "IEC61360",
  "title": "IEC 61360 (local)",
  "sourceLanguage": "en",
  "translationLanguages": [],
  "counts": { "class": 0, "property": 0, "value_list": 0,
              "value_term": 0, "unit": 0, "relation": 0,
              "view_control": 0 },
  "metaClassIrdis": []
}

Counts are optional — pages derive real numbers from the data at runtime. Then run it:

npm install
npm run dev    # http://localhost:4321

§ What you get locally

Everything. Definitions, remarks, dates, status, source-document references, full version history — the complete attribute set, licensed to your organization by IEC. The public site on purpose shows only the § 5 FREE ATTRIBUTES; your local OpenCDD shows it all. Same identifiers, same IRDIs, same engine.