Products

Reading diagrams

Why some diagrams are better than others, how to present diagrams, and how big or small to make them

This is a post about modeling.

More specifically, it’s about Visual modeling, that is, expressing abstractions of the world via diagrams.

So how we draw those diagrams – what we choose to put in them, what we try to say with them, is critical. So this article is going to serve as a starting point for ideas on:

  • Why some diagrams are better than others. This is really just a chance to show some of my personal favorites, and say why I think they are successful.
  • What to include in diagrams, to help us create better models. How to avoid visual- and meaning-overload
  • How to present diagrams, so people can read them. Some diagrams may just show our working-out, and are not for public consumption. Others are going to be our shop-window, our main deliverable. So presentation matters.
  • How big, or small, to make them. Size is important.

I’m sure that there is lots of psychology and information theory which has answers to all these questions, but these are some ideas from a modeling practitioner: if you know better, then please say so.

Why some diagrams are better than others

A great diagram speaks to us.

It tells us something, or better yet, allows us to discover something for ourselves, perhaps even something beyond what the author knew themselves. I generally start my courses on modeling with some good, and bad, examples, of model diagrams but my clear favorite is the Harry Beck London tube map.

Another, more recent example, was sent to me me by my daughter, and XKCD fan, and is a wonderfully informative and elegant infographic about radiation. When you next see an article on the TV about the terrible dangers of radiation, consult this diagram.

And the final one – for the moment – is the one which I treasure more than all others, as it’s the one which made me decide that modeling was a worthwhile human activity: the GoF ‘Composite’ Pattern:

composite

This is so simple: 3 boxes and 3 lines, but it conveys a concise solution to all kinds of problems. The first time a saw this (and had it explained to me, slowly) was a magical moment. Models can be simple, small, and still be wonderful.

So this is the target for what follows – how should we create diagrams which are simple, easy to read and understand, and which contain useful information and insights.

 

See also:

  • What to include in diagrams – ideas and content
  • How to present diagrams – presenting that content
  • Size – use and abuse. – link to LOOK AT ME DIAGRAMS

(first published on the “Artful Modeler” blog in 2015.)

More Insights

The eaTeamWorks product philosophy

22 November 2023

The eaTeamWorks product philosophy is simple - and it's all about you, the modeler.

Learn More

The role of diagrams in Enterprise Architect

20 November 2023

Not every modeling problem can be solved with a diagram. Some diagrams are essential, some are useful, but some may be misleading. But which ones?

Learn More

Explaining modelling

22 June 2023

..or, "how to reduce 20 years of modelling into 5 bullets". If you need to explain to someone what we do, try this short explanation.

Learn More

Where to start modelling

22 June 2023

Faced with an empty model and a problem to solve, where should you start? Some advice for people with no modelling experience

Learn More

Creating useful, long-lasting process models

22 June 2023

Process models are hard to maintain. Maybe that's because they have poor structure. Here are some ways to give them a longer life.

Learn More

eaTeamWorks Launch: What does this change mean for me?

15 June 2023

Information for existing eaDocX, Model Expert and Portfolio Manager license holders

Learn More

Create useful models using Sparx EA

1 June 2023

Advice for the new modeller #3 - Producing useful outputs with your new EA tool.

Learn More

What needs to be included in your EA model content?

1 June 2023

Advice for the new modeller #4 – (not) Modelling The World

Learn More

Beginners guide to Enterprise Architect software

1 June 2023

Our advice for new EA modellers

Learn More

How much domain modelling is enough?

1 June 2023

Advice for the new modeller #2 – (not) Melting the Pan

Learn More

Simplifying ideas in a BPMN Process Diagram

1 June 2023

How to find the right number of ideas to include in your model.

Learn More

Beck’s Map: an EA model abstraction example

1 June 2023

Possibly the best model abstraction in the world

Learn More

Process based model styles

1 June 2023

How to use BPMN and UML to make models which last.

Learn More

Where to start with Enterprise Architect data modeling

1 June 2023

BPM Tips: Advice for the new modeler #1

Learn More

Putting EA at the heart of your business

1 June 2023

Ian's workshop at the EA Global Summit on September 14th 2022

Learn More

Compare licence prices

Choose the licence that’s right for you and your team

Prices

Download a free trial

Download eaTeamWorks today for several free for life features, plus no obligation, 30-day trials of all the products: eaDocX, ea Revision Manager, eaSheets, Model Expert and PortfolioManager. Discover for yourself why we sell the world’s best-selling Enterprise Architect extension.

Download