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

Post a Comment

Popular posts from this blog

plotting - Plot 4D data with color as 4th dimension

I have a list of 4D data (x position, y position, amplitude, wavelength). I want to plot x, y, and amplitude on a 3D plot and have the color of the points correspond to the wavelength. I have seen many examples using functions to define color but my wavelength cannot be expressed by an analytic function. Is there a simple way to do this? Answer Here a another possible way to visualize 4D data: data = Flatten[Table[{x, y, x^2 + y^2, Sin[x - y]}, {x, -Pi, Pi,Pi/10}, {y,-Pi,Pi, Pi/10}], 1]; You can use the function Point along with VertexColors . Now the points are places using the first three elements and the color is determined by the fourth. In this case I used Hue, but you can use whatever you prefer. Graphics3D[ Point[data[[All, 1 ;; 3]], VertexColors -> Hue /@ data[[All, 4]]], Axes -> True, BoxRatios -> {1, 1, 1/GoldenRatio}]
Post a Comment
Read more

plotting - Filling between two spheres in SphericalPlot3D

Manipulate[ SphericalPlot3D[{1, 2 - n}, {θ, 0, Pi}, {ϕ, 0, 1.5 Pi}, Mesh -> None, PlotPoints -> 15, PlotRange -> {-2.2, 2.2}], {n, 0, 1}] I cant' seem to be able to make a filling between two spheres. I've already tried the obvious Filling -> {1 -> {2}} but Mathematica doesn't seem to like that option. Is there any easy way around this or ... Answer There is no built-in filling in SphericalPlot3D . One option is to use ParametricPlot3D to draw the surfaces between the two shells: Manipulate[ Show[SphericalPlot3D[{1, 2 - n}, {θ, 0, Pi}, {ϕ, 0, 1.5 Pi}, PlotPoints -> 15, PlotRange -> {-2.2, 2.2}], ParametricPlot3D[{ r {Sin[t] Cos[1.5 Pi], Sin[t] Sin[1.5 Pi], Cos[t]}, r {Sin[t] Cos[0 Pi], Sin[t] Sin[0 Pi], Cos[t]}}, {r, 1, 2 - n}, {t, 0, Pi}, PlotStyle -> Yellow, Mesh -> {2, 15}]], {n, 0, 1}]
Post a Comment
Read more

plotting - Mathematica: 3D plot based on combined 2D graphs

I have several sigmoidal fits to 3 different datasets, with mean fit predictions plus the 95% confidence limits (not symmetrical around the mean) and the actual data. I would now like to show these different 2D plots projected in 3D as in but then using proper perspective. In the link here they give some solutions to combine the plots using isometric perspective, but I would like to use proper 3 point perspective. Any thoughts? Also any way to show the mean points per time point for each series plus or minus the standard error on the mean would be cool too, either using points+vertical bars, or using spheres plus tubes. Below are some test data and the fit function I am using. Note that I am working on a logit(proportion) scale and that the final vertical scale is Log10(percentage). (* some test data *) data = Table[Null, {i, 4}]; data[[1]] = {{1, -5.8}, {2, -5.4}, {3, -0.8}, {4, -0.2}, {5, 4.6}, {1, -6.4}, {2, -5.6}, {3, -0.7}, {4, 0.04}, {5, 1.0}, {1, -6.8}, {2, -4.7}, {3, -1....
Post a Comment
Read more