Skip to main content

notebooks - How to get complete Documentation Center graph of guide pages?


On the very last image below you can see a typical path of walking through Documentation Center guide pages. What is the best way to get the graph data and visualize the whole structure of these connections starting from the main table of contents page? An obvious thing to do is to look for example into directory:


SetDirectory["C:\\Program Files\\Wolfram\\Research
\\Mathematica\\8.0\\Documentation\\English\\System\\Guides"]


FileNames[] // Column

enter image description here


But I am not sure what is the next most efficient way to analyze the connections.


A walk through guide pages


enter image description here


------------ UPDATE: new built-in WolframLanguageData ------------


I posted an answer in connection with newly released functionality - WL now contains data about itself.


------------ UPDATE: image from @Leoind data ------------



style = {VertexStyle -> White, VertexShapeFunction -> "Point", 
EdgeStyle -> Directive[Opacity[.3], Hue[.15, .5, .8]],
Background -> Black, EdgeShapeFunction -> (Line[#1] &),
ImageSize -> 500};

gr = Graph[Union[Sort /@ data], style]

enter image description here


The origin of self-loops was explained by @R.M in his comment. Almost all guide pages have their own URL at the top navigation bar. Here is the final graph with removed self-loops:


am = AdjacencyMatrix[gr];(am[[#, #]] = 0) & /@ Range[Length[am]];

AdjacencyGraph[am, style]

enter image description here



Answer



I will answer the technical part of the question - namely, how to get the entire graph. How one would go about analyzing and visualizing it, is another story.


This will open and parse a given guide notebook, and get the links to other notebooks:


ClearAll[getLinks];
getLinks[file_] :=
With[{nb = NotebookOpen[file]},
With[{result =

Cases[NotebookGet[nb], (ButtonData -> ref_) :> ref, Infinity]},
NotebookClose[nb];
result]];

This will filter out links to guides only:


ClearAll[getGuideLinks];
getGuideLinks[links_List] :=
Cases[links, l_String /; StringMatchQ[l, "paclet:guide" ~~ __]];

This extracts a name from the link:



ClearAll[nameFromLink];
nameFromLink[link_String] :=
If[# === {}, Sequence @@ {}, First@#] &@
StringCases[link, "paclet:guide/" ~~ x__ :> x];

This gets the names of all guides linked from a given one:


Clear[getLinkedGuideNames];
getLinkedGuideNames[guidefile_String] :=
Map[nameFromLink, getGuideLinks@getLinks@guidefile];


This constructs a list of graph rules from a list of files with guides:


Clear[getGraphRules];
getGraphRules[guideFiles : {__String}] :=
Flatten[
Thread[FileBaseName[#] -> getLinkedGuideNames[#]] & /@
guideFiles];

Here is a list of guides:


guides = 
FileNames["*",

"C:\\Program Files\\Wolfram Research\\Mathematica\\
8.0\\Documentation\\English\\System\\Guides"];

You can now, if you wish, construct a graph as follows:


Graph[Union[getGraphRules[guides]] /. Rule -> DirectedEdge]

but it is a huge graph which visually is not easy to analyze. One obviously needs to analyze it more locally by inducing subgraphs etc.


For convenience of anyone who would like to play with this, I placed the rules obtained with the above code into this gist.


Comments

Popular posts from this blog

plotting - How to draw lines between specified dots on ListPlot?

I would like to create a plot where I have unconnected dots and some connected. So far, I have figured out how to draw the dots. My code is the following: ListPlot[{{1, 1}, {2, 2}, {3, 3}, {4, 4}, {1, 4}, {2, 5}, {3, 6}, {4, 7}, {1, 7}, {2, 8}, {3, 9}, {4, 10}, {1, 10}, {2, 11}, {3, 12}, {4,13}, {2.5, 7}}, Ticks -> {{1, 2, 3, 4}, None}, AxesStyle -> Thin, TicksStyle -> Directive[Black, Bold, 12], Mesh -> Full] I have thought using ListLinePlot command, but I don't know how to specify to the command to draw only selected lines between the dots. Do have any suggestions/hints on how to do that? Thank you. Answer One possibility would be to use Epilog with Line : ListPlot[ {{1, 1}, {2, 2}, {3, 3}, {4, 4}, {1, 4}, {2, 5}, {3, 6}, {4, 7}, {1, 7}, {2, 8}, {3, 9}, {4, 10}, {1, 10}, {2, 11}, {3, 12}, {4, 13}, {2.5, 7}}, Ticks -> {{1, 2, 3, 4}, None}, AxesStyle -> Thin, TicksStyle -> Directive[Black, Bold, 12], Mesh -> Full, Epilog -> { Line[ ...

equation solving - Invert and fit implicitly defined curve

I need to fit an implicitly defined curve. I thought I could get some data out of Solve , and then using FindFit . Therefore, I would like to find the relation the parametric curve defined by $F(x,y)=0$: Solve[-(1/2) + 1/2 (0.41202 BesselK[0, 0.1 Sqrt[x^2 + y^2]] + (0.101483 x BesselK[1, 0.1 Sqrt[x^2 + y^2]])/Sqrt[x^2 + y^2]) == 0, y] But I can't get an output: Solve was unable to solve the system with inexact coefficients or the system obtained by direct rationalization of inexact numbers present in the system. Since many of the methods used by Solve require exact input, providing Solve with an exact version of the system may help. >> Edit: In particular, I would like to fit the data coming from the curve with the expression of another curve, and not with a function $f(x)$. In particular, since this clearly looks like a cardioid , I would like it to fit to something like it. What other strategies could I try?

dynamic - How can I make a clickable ArrayPlot that returns input?

I would like to create a dynamic ArrayPlot so that the rectangles, when clicked, provide the input. Can I use ArrayPlot for this? Or is there something else I should have to use? Answer ArrayPlot is much more than just a simple array like Grid : it represents a ranged 2D dataset, and its visualization can be finetuned by options like DataReversed and DataRange . These features make it quite complicated to reproduce the same layout and order with Grid . Here I offer AnnotatedArrayPlot which comes in handy when your dataset is more than just a flat 2D array. The dynamic interface allows highlighting individual cells and possibly interacting with them. AnnotatedArrayPlot works the same way as ArrayPlot and accepts the same options plus Enabled , HighlightCoordinates , HighlightStyle and HighlightElementFunction . data = {{Missing["HasSomeMoreData"], GrayLevel[ 1], {RGBColor[0, 1, 1], RGBColor[0, 0, 1], GrayLevel[1]}, RGBColor[0, 1, 0]}, {GrayLevel[0], GrayLevel...