Group Abstract Group Abstract

Message Boards Message Boards

9
|
13.6K Views
|
6 Replies
|
23 Total Likes
View groups...
Share
Share this post:

Why is some Graph functionality underdocumented to the point of unusabiliy?

Posted 6 years ago
POSTED BY: Szabolcs Horvát
6 Replies
Anonymous User
Anonymous User
Posted 6 years ago

If they are undocumented then they do nothing except what the examples show. (well programmed unix things, like Motif, have a variable exposed for anything that could change, and three ways to get at changing that exposed variable - almost to the point of monotony - yet ending up a compact program)

I liked earlier versions that had all .nb (or Put or Needs) for all kernel libraries.

However that makes it easy competition to steal and offer the same product at a lower $ (please internationalize that if need be).

Wolfram is outreaching to community and does answer such questions about some given function when the need arises though.

In my case I made a raytrace front end for mm and got really burned because many functions not only are undocumented but do not give Graphics output: they ONLY give opengl output internally so to replicate them it meant writing a new function that does the same thing for each one.

I probably should have asked wolfram a few questions to save time instead of doing certain things "the hard way". And that's my point. You have only to ask them.

((No matter if I went forward I would code it all in MM anyway, but because mm's 3D has gone new directions that are good but very different from rendering software abilities - i likely won't do it even as a hobby - because then i'd be also coding all of modern opengl use as well as all mm un-exposed things - a bit of a task for one unpaid person i'd say!))

My complaint would be Mathematica is great as a math swiss army pocket knife (the functions allow any specific goal to be achieve without providing a function for every conceivable goal). But Wolfram seems to have paid employees to add many small program functions that do very little (nothing that mathematica couldn't do without them), all in a name. On the other hand my PC is still running fast enough so I can't complain. The addition of Geo and Chem and other things are great.

However your answer may be this (an educated guess). DegreeGraphDistribution[] is used to provide a service to a higher Mathematica function that IS well documented, so you don't need to know how it works, because it is a service function. That's typically the kind of answer I've seen over the years which may apply here.

POSTED BY: Anonymous User

Update

I admit that the above was an impulse post stemming from frustration due to responses (or lack of) relayed by support. Now that it's out it can't be removed. I hope it did not antagonize anyone, as that wouldn't improve anything.

In fact, I think what could improve the situation would be more public interaction between the Graph developers and users. I think many of us feel like our feedback about this functionality area is often falling on deaf ears. By interaction, I do not mean generic statements that work is being done, but concrete comments on the specific issues that we bring up.

To be fair to the developers of the Graph functionality, I should note that the bug fixes that went into Mathematica 12.0 were well chosen. I really do wish that more issues had been fixed, but if WRI's resources only allowed for fixing this much, the prioritization was correct in my opinion. (Data corruption by [Edge|Vertex][Delete|Add] was indeed the most pressing issue.)

I also think that a big opportunity to gain goodwill was missed by not documenting the biggest Graph changes (property inheritance) for M12.0.

POSTED BY: Szabolcs Horvát
POSTED BY: Szabolcs Horvát

I should mention that despite stepping up the Graph bugfixes a bit for M12.0, there are still multiple bugs of the sort that should never survive for longer than a single release if they are known ...

For those who are unaware, don't ever trust any result from FindMaximumFlow or FindVertexCut ...

POSTED BY: Szabolcs Horvát

Szabolcs, please answer me frankly: is there any serious reason why to use Mathematica 12 for any kind of networks or graphs research?

From my point of view the Mathematica is going to be a more and more the magic black box tool, which is able to solve nearly everything, but surprisingly often not enough effectively and/or precisely.

Underdocumented functions are only one tip of problems iceberg.

Reply to this discussion
Community posts can be styled and formatted using the Markdown syntax.
Reply Preview
Attachments
Remove
or Discard