Author Topic: Presentation Models and Diagrams  (Read 9007 times)

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8607
  • Karma: +257/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Presentation Models and Diagrams
« on: January 25, 2019, 05:44:53 pm »
We have a, hopefully, fairly rigorous model in our repository.  The model, we hope, accurately reflects the real world such that we are able to make useful analyses and recommendations.  We'll call this the rigorous model.

However, rigour often gets in the way of simplicity and communication.  Simplicity is necessary for communication with others via presentations.  We have to keep it simple, without making it simplistic!  We can make use of derived relationships in the rigorous model to create diagrams which have a simplified view of items and their interrelationships.

However, the objects in the rigorous model are very rich and surface many properties.  The diagrams look cluttered and busy also, the restrictions on things like line width pose problems.  We initially thought that we'd just create more complex shapescripts that would allow us to "simplify" the items, but eventually, we realised that we really needed a separate "presentation" model and diagrams.

Typically, presentation models and diagrams are used to achieve a decision (particularly at an executive level).  As I have said in the past, "When you can see the problem, you can see the problem..."  So, for a presentation diagram, we need to know the message being rendered (this is true for all diagrams, but particularly so for these diagrams).

The presentation model consists of special presentation items vertices which have special rendering properties (see below) to allow us to simulate (to an extent) the kind of varying shapes you see on presentation software diagrams - like PowerPoint etc.  However, these vertices are linked to an item in the rigorous model by means of a special "View of" relationship (the presentation item is a view of the rigorous item).  The rigorous model has a large number of metatypes (to give us the level of modelling we believe we need).  We've tried to reduce the number of metatypes in the presentation model to less than a dozen - similar to a metaclass abstraction.  We can, therefore, provide a mapping between the rigorous metatype and the presentation metatype (including the provision of a property indicating the subtype for the presentation metatype).  An example might be Business Function {rigorous} => Activity (subtype Function) {presentation}.

We hope to be able to maintain this mapping over time.  Since the "View of" relationship exists, we can track the changes required in the presentation model as the rigorous model evolves.

In the presentation software diagrams, the items can be of arbitrary shapes.  So we determined that a boundary item can provide much of the shape management we think we need.  This is particularly true of the boundary user-defined shapes (Orthogonal, Freeform), however, there are issues.  One is that boundaries do not appear on the browser.  In our case, this is alleviated by our separating items from the diagrams into defined locations - so any such presentation items would be moved to the appropriate folders - where you still can't see them!  However, because we create Neighborhood diagrams for all our items, and ensure that the diagrams are always collocated with the item, the Neighborhood diagram acts as a suitable proxy for the item.  So while the items aren't visible directly, their diagrams are.  (We use the same technique for other items that aren't normally visible in the browser)

We have also investigated creating WIDE connectors to be more prominent.  Again, while there are issues - they only seem to work well with certain line styles.  They seem usable.

The reason for this email is to get any feedback before we embark on a serious attempt to create such presentation models and diagrams from our rigorous models.

Thoughts and suggestions welcome.
Paolo
Inconsistently correct systems DON'T EXIST!
... Therefore, aim for consistency; in the expectation of achieving correctness....
-Semantica-
Helsinki Principle Rules!

qwerty

  • EA Guru
  • *****
  • Posts: 13584
  • Karma: +396/-301
  • I'm no guru at all
    • View Profile
Re: Presentation Models and Diagrams
« Reply #1 on: January 25, 2019, 07:30:09 pm »
If I get it right you are after a dynamic highlighting of certain connections in a diagram. I guess that won't work. Diagrams are not meant as one big overview where you just highlight a complex scenario. Rather create separate diagrams for those aspects. Deducing from the length of the mail the basic issue is for sure not trivial. But you should probably stand back a bit and look at it from a different angle.

q.

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8607
  • Karma: +257/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: Presentation Models and Diagrams
« Reply #2 on: January 25, 2019, 09:16:45 pm »
If I get it right you are after a dynamic highlighting of certain connections in a diagram. I guess that won't work. Diagrams are not meant as one big overview where you just highlight a complex scenario. Rather create separate diagrams for those aspects. Deducing from the length of the mail the basic issue is for sure, not trivial. But you should probably stand back a bit and look at it from a different angle.

q.
I think you missed my point, q.  I didn't make it clear enough.  Most of these presentation diagrams are very simple.  They need bold, highly visible, simple (looking objects).  I've even been asked to remove the horizontal line on a class!  Consequently, the normal metatypes we use for the diagrams in the rigorous model just won't do.  Think presentations to the C-suite in your choice of presentation software.

I used to say "managers and executives can handle a query so long as it's one table with simple conditions.  Use two or more tables and all bets are off!"  Another of my aphorisms is "a picture is worth a thousand words until there are more than 6 boxes and 12 lines when all bets are off!"

We need REALLY simple diagrams that are still conceptually valid (against the rigorous model).

Paolo
Inconsistently correct systems DON'T EXIST!
... Therefore, aim for consistency; in the expectation of achieving correctness....
-Semantica-
Helsinki Principle Rules!

Erlenmeyer

  • EA User
  • **
  • Posts: 27
  • Karma: +0/-0
    • View Profile
Re: Presentation Models and Diagrams
« Reply #3 on: February 01, 2019, 06:16:36 am »
"Think presentations to the C-suite in your choice of presentation software"
This is why my team has lost its dignity and is using PowerPoint for executive presentations.

Sunshine

  • EA Practitioner
  • ***
  • Posts: 1319
  • Karma: +121/-10
  • Its the results that count
    • View Profile
Re: Presentation Models and Diagrams
« Reply #4 on: February 01, 2019, 08:07:15 am »
How does the saying go?
If you can't explain it simply ...
Happy to help
:)

qwerty

  • EA Guru
  • *****
  • Posts: 13584
  • Karma: +396/-301
  • I'm no guru at all
    • View Profile
Re: Presentation Models and Diagrams
« Reply #5 on: February 01, 2019, 09:06:37 am »
Well, in PowerPoint you can represent anything. In a way so nobody can understand a single bit.

q.

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8607
  • Karma: +257/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: Presentation Models and Diagrams
« Reply #6 on: February 01, 2019, 10:47:10 am »
Well, in PowerPoint you can represent anything. In a way so nobody can understand a single bit.

q.
Indeed, that's the reason for Presentation Models.  They're simple but they ARE models!

Anyway,  we've found the first real problem in our "proof of concept".

While our boundary based vertices can be searched for in the Model searches and come up quite well, they can't be used in matrix profiles because they are suppressed.  The search appears to return the list, but the matrix profiler suppresses them because they aren't visible in the browser (my guess).  We changed the underlying type to a browser visible value and bingo, there they were in the matrix!

To paraphrase GK, "It's a bug, !"

Reported,
Paolo
Inconsistently correct systems DON'T EXIST!
... Therefore, aim for consistency; in the expectation of achieving correctness....
-Semantica-
Helsinki Principle Rules!

Glassboy

  • EA Practitioner
  • ***
  • Posts: 1367
  • Karma: +112/-75
    • View Profile
Re: Presentation Models and Diagrams
« Reply #7 on: February 01, 2019, 12:13:51 pm »
How does the saying go?
If you can't explain it simply ...

If you can't draw it with crayons you don't understand it.

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8607
  • Karma: +257/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: Presentation Models and Diagrams
« Reply #8 on: February 01, 2019, 01:03:41 pm »
How does the saying go?
If you can't explain it simply ...

If you can't draw it with crayons you don't understand it.
Except it's the viewer that needs to understand, not the drawer...

As Einstein is reported to have said (the so-called Einsteinian dictum)  "Keep things as simple as possible, but no simpler!"   The latter part of the aphorism is too often ignored (producing a simplistic rather than most simple result).

Paolo
Inconsistently correct systems DON'T EXIST!
... Therefore, aim for consistency; in the expectation of achieving correctness....
-Semantica-
Helsinki Principle Rules!

Glassboy

  • EA Practitioner
  • ***
  • Posts: 1367
  • Karma: +112/-75
    • View Profile
Re: Presentation Models and Diagrams
« Reply #9 on: February 01, 2019, 01:41:56 pm »
How does the saying go?
If you can't explain it simply ...

If you can't draw it with crayons you don't understand it.
Except it's the viewer that needs to understand, not the drawer...

The failure to explain is generally a failure to understand it yourself.

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8607
  • Karma: +257/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: Presentation Models and Diagrams
« Reply #10 on: February 01, 2019, 03:58:35 pm »
How does the saying go?
If you can't explain it simply ...

If you can't draw it with crayons you don't understand it.
Except it's the viewer that needs to understand, not the drawer...

The failure to explain is generally a failure to understand it yourself.
There's an assumption there that, in my experience isn't universally valid.

The recent Brexit vote is an illustration of the invalidity.
(paraphrased) Quote from a young British person: "Where I voted to leave, I didn't mean that they should leave".

I am continually amazed by the number of people who use words whose meaning they don't actually know (nevermind understand).

Paolo
Inconsistently correct systems DON'T EXIST!
... Therefore, aim for consistency; in the expectation of achieving correctness....
-Semantica-
Helsinki Principle Rules!

KP

  • EA Administrator
  • EA Expert
  • *****
  • Posts: 2919
  • Karma: +54/-3
    • View Profile
Re: Presentation Models and Diagrams
« Reply #11 on: February 01, 2019, 04:18:48 pm »
How does the saying go?
If you can't explain it simply ...

If you can't draw it with crayons you don't understand it.
Except it's the viewer that needs to understand, not the drawer...

The failure to explain is generally a failure to understand it yourself.
There's an assumption there that, in my experience isn't universally valid.

The recent Brexit vote is an illustration of the invalidity.
(paraphrased) Quote from a young British person: "Where I voted to leave, I didn't mean that they should leave".

I am continually amazed by the number of people who use words whose meaning they don't actually know (nevermind understand).

Paolo

I think at the end of the day, I would rather trust a drawing that the author understood than one that the author didn't understand, so I'm with Glassboy. And I can't talk about Brexit in my house because my dog thinks I'm saying "biscuit" and gets excited.
The Sparx Team
[email protected]

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8607
  • Karma: +257/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: Presentation Models and Diagrams
« Reply #12 on: February 01, 2019, 05:33:57 pm »
[SNIP]
There's an assumption there that, in my experience isn't universally valid.

The recent Brexit vote is an illustration of the invalidity.
(paraphrased) Quote from a young British person: "Where I voted to leave, I didn't mean that they should leave".

I am continually amazed by the number of people who use words whose meaning they don't actually know (nevermind understand).

Paolo
I think at the end of the day, I would rather trust a drawing that the author understood than one that the author didn't understand, so I'm with Glassboy. And I can't talk about Brexit in my house because my dog thinks I'm saying "biscuit" and gets excited.
It would appear I, too, made an assumption not universally valid, that the drawer understood their own diagram.
So since, as we know, communication is a two-way process.  We need to have understanding on both sides.

Paolo
Inconsistently correct systems DON'T EXIST!
... Therefore, aim for consistency; in the expectation of achieving correctness....
-Semantica-
Helsinki Principle Rules!

Glassboy

  • EA Practitioner
  • ***
  • Posts: 1367
  • Karma: +112/-75
    • View Profile
Re: Presentation Models and Diagrams
« Reply #13 on: February 04, 2019, 07:45:52 am »
The recent Brexit vote is an illustration of the invalidity.
(paraphrased) Quote from a young British person: "Where I voted to leave, I didn't mean that they should leave".

I'd dispute that.  Commentary on Brexit is an illustration of how separated media in "western" nations has come from the context that normal people operate and communicate in.  Vox pox can be made to mean anything.

Which is why presentation diagrams have to be simple and in the language of the people.

RoyC

  • EA Administrator
  • EA Practitioner
  • *****
  • Posts: 1297
  • Karma: +21/-4
  • Read The Help!
    • View Profile
Re: Presentation Models and Diagrams
« Reply #14 on: February 05, 2019, 12:08:56 pm »
"Vox pox can be made to mean anything."

Regardless of what they meant, I wouldn't trust anything that any variety of pox had to say...
Best Regards, Roy