[08/10] tinkerpop git commit: Merge branch 'tp33'
Merge branch 'tp33' Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/9b3ffe9f Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/9b3ffe9f Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/9b3ffe9f Branch: refs/heads/TINKERPOP-1990 Commit: 9b3ffe9f0ab4f37ca823e78974f817c5a2e200ff Parents: c18582d 4973070 Author: Stephen Mallette Authored: Fri Jun 22 10:51:44 2018 -0400 Committer: Stephen Mallette Committed: Fri Jun 22 10:51:44 2018 -0400 -- docs/src/index.asciidoc | 2 +- docs/static/images/practical-gremlin.png | Bin 0 -> 392179 bytes pom.xml | 13 ++--- 3 files changed, 11 insertions(+), 4 deletions(-) -- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/9b3ffe9f/pom.xml --
[03/10] tinkerpop git commit: Merge branch 'tp33'
Merge branch 'tp33' Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/b5bae4c9 Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/b5bae4c9 Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/b5bae4c9 Branch: refs/heads/TINKERPOP-1990 Commit: b5bae4c9cb1c7da3e9c1df82ed733a0691d6e0fb Parents: b5600e7 1309777 Author: Stephen Mallette Authored: Fri Jun 22 08:32:05 2018 -0400 Committer: Stephen Mallette Committed: Fri Jun 22 08:32:05 2018 -0400 -- docs/src/reference/the-traversal.asciidoc | 19 +++ 1 file changed, 19 insertions(+) -- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/b5bae4c9/docs/src/reference/the-traversal.asciidoc --
[09/10] tinkerpop git commit: TINKERPOP-1990 Implemented `ShortestPathVertexProgram` and `ShortestPathVertexProgramStep`.
http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/823e9354/gremlin-test/src/main/java/org/apache/tinkerpop/gremlin/process/computer/search/path/ShortestPathTestHelper.java
--
diff --git
a/gremlin-test/src/main/java/org/apache/tinkerpop/gremlin/process/computer/search/path/ShortestPathTestHelper.java
b/gremlin-test/src/main/java/org/apache/tinkerpop/gremlin/process/computer/search/path/ShortestPathTestHelper.java
new file mode 100644
index 000..7f3aa63
--- /dev/null
+++
b/gremlin-test/src/main/java/org/apache/tinkerpop/gremlin/process/computer/search/path/ShortestPathTestHelper.java
@@ -0,0 +1,100 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.tinkerpop.gremlin.process.computer.search.path;
+
+import org.apache.tinkerpop.gremlin.process.AbstractGremlinProcessTest;
+import org.apache.tinkerpop.gremlin.process.traversal.P;
+import org.apache.tinkerpop.gremlin.process.traversal.Path;
+import
org.apache.tinkerpop.gremlin.process.traversal.dsl.graph.GraphTraversalSource;
+import org.apache.tinkerpop.gremlin.process.traversal.dsl.graph.__;
+import org.apache.tinkerpop.gremlin.process.traversal.step.util.ImmutablePath;
+import org.apache.tinkerpop.gremlin.process.traversal.step.util.MapHelper;
+import org.apache.tinkerpop.gremlin.process.traversal.step.util.MutablePath;
+import org.apache.tinkerpop.gremlin.structure.Edge;
+import org.apache.tinkerpop.gremlin.structure.Vertex;
+import org.hamcrest.Matchers;
+
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.is;
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertThat;
+
+/**
+ * @author Daniel Kuppitz (http://gremlin.guru)
+ */
+public class ShortestPathTestHelper {
+
+private final AbstractGremlinProcessTest test;
+private final GraphTraversalSource g;
+private final Map vertexCache;
+private final Map> edgeCache;
+
+public ShortestPathTestHelper(final AbstractGremlinProcessTest test, final
GraphTraversalSource g) {
+this.test = test;
+this.g = g;
+this.vertexCache = new HashMap<>();
+this.edgeCache = new HashMap<>();
+}
+
+public void checkResults(final List expected, final List
actual) {
+AbstractGremlinProcessTest.checkResults(expected,
__.inject(actual.toArray(new Path[actual.size()])));
+}
+
+public Path makePath(final String... names) {
+return makePath(false, names);
+}
+
+public Path makePath(final boolean includeEdges, final String... names) {
+Path path = ImmutablePath.make();
+boolean first = true;
+for (final String name : names) {
+final Vertex vertex = vertexCache.computeIfAbsent(name,
test::convertToVertex);
+if (!first) {
+if (includeEdges) {
+final Object id1 = ((Vertex) path.get(path.size() -
1)).id();
+final Object id2 = vertex.id();
+final Edge edge;
+if (edgeCache.containsKey(id1)) {
+edge = edgeCache.get(id1).computeIfAbsent(id2, id ->
getEdge(id1, id));
+} else if (edgeCache.containsKey(id2)) {
+edge = edgeCache.get(id2).computeIfAbsent(id1, id ->
getEdge(id, id2));
+} else {
+edgeCache.put(id1, new HashMap<>());
+edgeCache.get(id1).put(id2, edge = getEdge(id1, id2));
+}
+path = path.extend(edge, Collections.emptySet());
+}
+}
+path = path.extend(vertex, Collections.emptySet());
+first = false;
+}
+return path;
+}
+
+private Edge getEdge(final Object id1, final Object id2) {
+return g.V(id1)
+.bothE().filter(__.otherV().hasId(id2))
+.next();
+}
+}
[10/10] tinkerpop git commit: TINKERPOP-1990 Implemented `ShortestPathVertexProgram` and `ShortestPathVertexProgramStep`.
TINKERPOP-1990 Implemented `ShortestPathVertexProgram` and
`ShortestPathVertexProgramStep`.
Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo
Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/823e9354
Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/823e9354
Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/823e9354
Branch: refs/heads/TINKERPOP-1990
Commit: 823e935411ce5fd119549fc637d8de30efcd0753
Parents: 9b3ffe9
Author: Daniel Kuppitz
Authored: Wed May 23 08:46:34 2018 -0400
Committer: Daniel Kuppitz
Committed: Fri Jun 22 08:03:28 2018 -0700
--
CHANGELOG.asciidoc | 1 +
docs/src/reference/the-graphcomputer.asciidoc | 51 ++
docs/src/reference/the-traversal.asciidoc | 56 ++
.../tinkerpop/gremlin/jsr223/CoreImports.java | 4 +
.../search/path/ShortestPathVertexProgram.java | 557 +++
.../traversal/step/map/ShortestPath.java| 108
.../step/map/ShortestPathVertexProgramStep.java | 174 ++
.../gremlin/process/remote/RemoteGraph.java | 8 +
.../gremlin/process/traversal/Traversal.java| 16 +-
.../traversal/dsl/graph/GraphTraversal.java | 20 +
.../traversal/lambda/ColumnTraversal.java | 8 +
.../traversal/lambda/ConstantTraversal.java | 9 +-
.../traversal/lambda/ElementValueTraversal.java | 10 +-
.../traversal/lambda/IdentityTraversal.java | 7 +-
.../process/traversal/lambda/LoopTraversal.java | 6 +
.../traversal/lambda/TokenTraversal.java| 8 +
.../process/traversal/lambda/TrueTraversal.java | 5 +
.../structure/io/graphson/GraphSONModule.java | 2 +-
.../gremlin/structure/io/gryo/GryoVersion.java | 7 +-
.../structure/io/gryo/UtilSerializers.java | 15 +
.../gremlin/structure/util/Attachable.java | 3 +-
.../traversal/dsl/graph/GraphTraversalTest.java | 2 +-
.../Process/Traversal/GraphTraversal.cs | 18 +
.../lib/process/graph-traversal.js | 10 +
.../gremlin_python/process/graph_traversal.py | 4 +
.../tinkerpop/gremlin/AbstractGremlinTest.java | 6 +-
.../process/AbstractGremlinProcessTest.java | 11 +-
.../gremlin/process/ProcessComputerSuite.java | 5 +
.../search/path/ShortestPathTestHelper.java | 100
.../path/ShortestPathVertexProgramTest.java | 297 ++
.../traversal/step/map/ShortestPathTest.java| 353
pom.xml | 3 +
32 files changed, 1862 insertions(+), 22 deletions(-)
--
http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/823e9354/CHANGELOG.asciidoc
--
diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc
index b305bb7..a153763 100644
--- a/CHANGELOG.asciidoc
+++ b/CHANGELOG.asciidoc
@@ -25,6 +25,7 @@
image::https://raw.githubusercontent.com/apache/tinkerpop/master/docs/static/ima
This release also includes changes from <>.
+* Implemented `ShortestPathVertexProgram` and the `shortestPath()` step.
* Moved `Parameterizing` interface to the
`org.apache.tinkerpop.gremlin.process.traversal.step` package with other marker
interfaces of its type.
* Replaced `Parameterizing.addPropertyMutations()` with
`Configuring.configure()`.
* Changed interface hierarchy for `Parameterizing` and `Mutating` interfaces
as they are tightly related.
http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/823e9354/docs/src/reference/the-graphcomputer.asciidoc
--
diff --git a/docs/src/reference/the-graphcomputer.asciidoc
b/docs/src/reference/the-graphcomputer.asciidoc
index 4bf39d0..e4da605 100644
--- a/docs/src/reference/the-graphcomputer.asciidoc
+++ b/docs/src/reference/the-graphcomputer.asciidoc
@@ -403,6 +403,57 @@ g.V().peerPressure().by('cluster').valueMap()
g.V().peerPressure().by(outE('knows')).by('cluster').valueMap()
+[[shortestpathvertexprogram]]
+=== ShortestPathVertexProgram
+
+The `ShortestPathVertexProram` provides an easy way to find shortest
non-cyclic paths in the graph. It provides several options to configure
+the output format, the start- and end-vertices, the direction, a custom
distance function, as well as a distance limitation. By default it just
+finds all undirected, shortest paths in the graph.
+
+[gremlin-groovy,modern]
+
+spvp = ShortestPathVertexProgram.build().create() <1>
+result = graph.compute().program(spvp).submit().get() <2>
+result.memory().get(ShortestPathVertexProgram.SHORTEST_PATHS) <3>
+
+
+<1> Create a `ShortestPathVertexProgram` with its default configuration.
+<2> Execute the `ShortestPathVertexProgram`.
+<3> Get all shortest paths from the results memory.
+
+[gremlin-groovy,modern]
+
+spvp =
[01/10] tinkerpop git commit: Clarification around random walks CTR [Forced Update!]
Repository: tinkerpop
Updated Branches:
refs/heads/TINKERPOP-1990 94f813f4d -> 823e93541 (forced update)
Clarification around random walks CTR
Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo
Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/aef2f6ca
Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/aef2f6ca
Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/aef2f6ca
Branch: refs/heads/TINKERPOP-1990
Commit: aef2f6ca0f8f1f62cb8220b01afc49d70714692f
Parents: 7c7dddb
Author: Stephen Mallette
Authored: Fri Jun 22 08:31:16 2018 -0400
Committer: Stephen Mallette
Committed: Fri Jun 22 08:31:16 2018 -0400
--
docs/src/reference/the-traversal.asciidoc | 19 +++
1 file changed, 19 insertions(+)
--
http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/aef2f6ca/docs/src/reference/the-traversal.asciidoc
--
diff --git a/docs/src/reference/the-traversal.asciidoc
b/docs/src/reference/the-traversal.asciidoc
index b600b7a..8cc6ac0 100644
--- a/docs/src/reference/the-traversal.asciidoc
+++ b/docs/src/reference/the-traversal.asciidoc
@@ -2191,6 +2191,25 @@ g.V(1).repeat(local(
)).times(10).path()
+As a clarification, note that in the above example `local()` is not strictly
required as it only does the random walk
+over a single vertex, but note what happens without it if multiple vertices
are traversed:
+
+[gremlin-groovy,modern]
+
+g.V().repeat(bothE().sample(1).by('weight').otherV()).times(5).path()
+
+
+The use of `local()` ensures that the traversal over `bothE()` occurs once per
vertex traverser that passes through,
+thus allowing one random walk per vertex.
+
+[gremlin-groovy,modern]
+
+g.V().repeat(local(bothE().sample(1).by('weight').otherV())).times(5).path()
+
+
+So, while not strictly required, it is likely better to be explicit with the
use of `local()` so that the proper intent
+of the traversal is expressed.
+
*Additional References*
link:++http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#sample-int-++[`sample(int)`],
[02/10] tinkerpop git commit: Merge branch 'tp32' into tp33
Merge branch 'tp32' into tp33 Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/1309777d Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/1309777d Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/1309777d Branch: refs/heads/TINKERPOP-1990 Commit: 1309777d7772818ef0810182a09a30503eeefef8 Parents: e1ef8b6 aef2f6c Author: Stephen Mallette Authored: Fri Jun 22 08:31:53 2018 -0400 Committer: Stephen Mallette Committed: Fri Jun 22 08:31:53 2018 -0400 -- docs/src/reference/the-traversal.asciidoc | 19 +++ 1 file changed, 19 insertions(+) -- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/1309777d/docs/src/reference/the-traversal.asciidoc --
[06/10] tinkerpop git commit: Added practical gremlin logo to doc listing CTR
Added practical gremlin logo to doc listing CTR Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/32aebb8f Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/32aebb8f Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/32aebb8f Branch: refs/heads/TINKERPOP-1990 Commit: 32aebb8f021673c2a58778ecced05ff6370302cc Parents: 8363ad5 Author: Stephen Mallette Authored: Fri Jun 22 10:49:59 2018 -0400 Committer: Stephen Mallette Committed: Fri Jun 22 10:49:59 2018 -0400 -- docs/src/index.asciidoc | 2 +- docs/static/images/practical-gremlin.png | Bin 0 -> 392179 bytes 2 files changed, 1 insertion(+), 1 deletion(-) -- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/32aebb8f/docs/src/index.asciidoc -- diff --git a/docs/src/index.asciidoc b/docs/src/index.asciidoc index f07bd99..90852e6 100644 --- a/docs/src/index.asciidoc +++ b/docs/src/index.asciidoc @@ -70,7 +70,7 @@ A brief overview of RDBMS architecture in comparison to graph, basic graph termi and an overview of Gremlin. (*external*) ^|image:gremlin-compendium.png[width=200] |link:http://www.doanduyhai.com/blog/?p=13460[The Gremlin Compendium, minimum survival kit for any Gremlin user] + A series of blog posts that examine the Gremlin language in the context of various graph traversal patterns. (*external*) -^|image:gremlin-running.png[width=125] |link:http://kelvinlawrence.net/book/Gremlin-Graph-Guide.html[Graph Databases, Gremlin and TinkerPop: A Tutorial] + +^|image:practical-gremlin.png[width=200] |link:http://kelvinlawrence.net/book/Gremlin-Graph-Guide.html[Practical Gremlin: An Apache TinkerPop Tutorial] + A getting started guide for users of graph databases and the Gremlin query language featuring hints, tips and sample queries. (*external*) |= http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/32aebb8f/docs/static/images/practical-gremlin.png -- diff --git a/docs/static/images/practical-gremlin.png b/docs/static/images/practical-gremlin.png new file mode 100755 index 000..f080e65 Binary files /dev/null and b/docs/static/images/practical-gremlin.png differ
[07/10] tinkerpop git commit: Merge branch 'tp32' into tp33
Merge branch 'tp32' into tp33 Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/49730704 Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/49730704 Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/49730704 Branch: refs/heads/TINKERPOP-1990 Commit: 49730704e3c840f089b674faece506d9a6ab3a69 Parents: 1309777 32aebb8 Author: Stephen Mallette Authored: Fri Jun 22 10:51:33 2018 -0400 Committer: Stephen Mallette Committed: Fri Jun 22 10:51:33 2018 -0400 -- docs/src/index.asciidoc | 2 +- docs/static/images/practical-gremlin.png | Bin 0 -> 392179 bytes pom.xml | 13 ++--- 3 files changed, 11 insertions(+), 4 deletions(-) -- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/49730704/pom.xml --
[05/10] tinkerpop git commit: Fixed a problem where index.asciidoc wasn't processing to html right CTR
Fixed a problem where index.asciidoc wasn't processing to html right CTR
Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo
Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/8363ad56
Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/8363ad56
Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/8363ad56
Branch: refs/heads/TINKERPOP-1990
Commit: 8363ad560a4a9e679d401b051952a1856ce570c0
Parents: aef2f6c
Author: Stephen Mallette
Authored: Fri Jun 22 10:49:50 2018 -0400
Committer: Stephen Mallette
Committed: Fri Jun 22 10:49:50 2018 -0400
--
pom.xml | 13 ++---
1 file changed, 10 insertions(+), 3 deletions(-)
--
http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/8363ad56/pom.xml
--
diff --git a/pom.xml b/pom.xml
index 155db82..d13f60e 100644
--- a/pom.xml
+++ b/pom.xml
@@ -866,11 +866,18 @@ limitations under the License.
-
${asciidoc.input.dir}/
-
${htmlsingle.output.dir}/
-
${asciidoc.input.dir}/static/*.*
+
${asciidoc.input.dir}
+
${htmlsingle.output.dir}
+
+
index.asciidoc
+
+
+
${asciidoc.input.dir}/static/*.*
+
+
${asciidoc.input.dir}
+
${htmlsingle.output.dir}
index.asciidoc
html5
article
[04/10] tinkerpop git commit: Added practical gremlin logo
Added practical gremlin logo Put logo and link on home page replacing the old Getting Started logo. https://lists.apache.org/thread.html/14d31ed24d7618253ba34cb0735c28f59b87096126d04242caa149bb@%3Cdev.tinkerpop.apache.org%3E CTR Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/c18582d2 Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/c18582d2 Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/c18582d2 Branch: refs/heads/TINKERPOP-1990 Commit: c18582d2a1858b54d993053d1ba47d08c8b61b84 Parents: b5bae4c Author: Stephen Mallette Authored: Fri Jun 22 10:42:44 2018 -0400 Committer: Stephen Mallette Committed: Fri Jun 22 10:42:44 2018 -0400 -- docs/site/home/img/practical-gremlin-titled.png | Bin 0 -> 412544 bytes docs/site/home/index.html | 4 ++-- docs/site/home/template/header-footer.html | 3 +++ 3 files changed, 5 insertions(+), 2 deletions(-) -- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/c18582d2/docs/site/home/img/practical-gremlin-titled.png -- diff --git a/docs/site/home/img/practical-gremlin-titled.png b/docs/site/home/img/practical-gremlin-titled.png new file mode 100755 index 000..265f3a2 Binary files /dev/null and b/docs/site/home/img/practical-gremlin-titled.png differ http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/c18582d2/docs/site/home/index.html -- diff --git a/docs/site/home/index.html b/docs/site/home/index.html index d882049..e67306e 100644 --- a/docs/site/home/index.html +++ b/docs/site/home/index.html @@ -47,8 +47,8 @@ limitations under the License. - http://tinkerpop.apache.org/docs/current/tutorials/getting-started;> - + http://kelvinlawrence.net/book/Gremlin-Graph-Guide.html;> + http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/c18582d2/docs/site/home/template/header-footer.html -- diff --git a/docs/site/home/template/header-footer.html b/docs/site/home/template/header-footer.html index b49ed42..ef86a3c 100644 --- a/docs/site/home/template/header-footer.html +++ b/docs/site/home/template/header-footer.html @@ -100,6 +100,9 @@ limitations under the License. http://tinkerpop.apache.org/docs/current/tutorials/the-gremlin-console/;>The Gremlin Console http://tinkerpop.apache.org/docs/current/recipes/;>Gremlin Recipes http://tinkerpop.apache.org/docs/current/tutorials/gremlin-language-variants/;>Gremlin Language Variants + http://tinkerpop.apache.org/docs/current/tutorials/gremlins-anatomy/;>Gremlin's Anatomy + + http://kelvinlawrence.net/book/Gremlin-Graph-Guide.html;>Book: Practical Gremlin by Kelvin Lawrence http://sql2gremlin.com/;>SQL2Gremlin
[2/4] tinkerpop git commit: Added practical gremlin logo to doc listing CTR
Added practical gremlin logo to doc listing CTR Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/32aebb8f Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/32aebb8f Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/32aebb8f Branch: refs/heads/master Commit: 32aebb8f021673c2a58778ecced05ff6370302cc Parents: 8363ad5 Author: Stephen Mallette Authored: Fri Jun 22 10:49:59 2018 -0400 Committer: Stephen Mallette Committed: Fri Jun 22 10:49:59 2018 -0400 -- docs/src/index.asciidoc | 2 +- docs/static/images/practical-gremlin.png | Bin 0 -> 392179 bytes 2 files changed, 1 insertion(+), 1 deletion(-) -- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/32aebb8f/docs/src/index.asciidoc -- diff --git a/docs/src/index.asciidoc b/docs/src/index.asciidoc index f07bd99..90852e6 100644 --- a/docs/src/index.asciidoc +++ b/docs/src/index.asciidoc @@ -70,7 +70,7 @@ A brief overview of RDBMS architecture in comparison to graph, basic graph termi and an overview of Gremlin. (*external*) ^|image:gremlin-compendium.png[width=200] |link:http://www.doanduyhai.com/blog/?p=13460[The Gremlin Compendium, minimum survival kit for any Gremlin user] + A series of blog posts that examine the Gremlin language in the context of various graph traversal patterns. (*external*) -^|image:gremlin-running.png[width=125] |link:http://kelvinlawrence.net/book/Gremlin-Graph-Guide.html[Graph Databases, Gremlin and TinkerPop: A Tutorial] + +^|image:practical-gremlin.png[width=200] |link:http://kelvinlawrence.net/book/Gremlin-Graph-Guide.html[Practical Gremlin: An Apache TinkerPop Tutorial] + A getting started guide for users of graph databases and the Gremlin query language featuring hints, tips and sample queries. (*external*) |= http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/32aebb8f/docs/static/images/practical-gremlin.png -- diff --git a/docs/static/images/practical-gremlin.png b/docs/static/images/practical-gremlin.png new file mode 100755 index 000..f080e65 Binary files /dev/null and b/docs/static/images/practical-gremlin.png differ
[3/3] tinkerpop git commit: Merge branch 'tp32' into tp33
Merge branch 'tp32' into tp33 Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/49730704 Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/49730704 Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/49730704 Branch: refs/heads/tp33 Commit: 49730704e3c840f089b674faece506d9a6ab3a69 Parents: 1309777 32aebb8 Author: Stephen Mallette Authored: Fri Jun 22 10:51:33 2018 -0400 Committer: Stephen Mallette Committed: Fri Jun 22 10:51:33 2018 -0400 -- docs/src/index.asciidoc | 2 +- docs/static/images/practical-gremlin.png | Bin 0 -> 392179 bytes pom.xml | 13 ++--- 3 files changed, 11 insertions(+), 4 deletions(-) -- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/49730704/pom.xml --
[1/2] tinkerpop git commit: Fixed a problem where index.asciidoc wasn't processing to html right CTR
Repository: tinkerpop
Updated Branches:
refs/heads/tp32 aef2f6ca0 -> 32aebb8f0
Fixed a problem where index.asciidoc wasn't processing to html right CTR
Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo
Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/8363ad56
Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/8363ad56
Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/8363ad56
Branch: refs/heads/tp32
Commit: 8363ad560a4a9e679d401b051952a1856ce570c0
Parents: aef2f6c
Author: Stephen Mallette
Authored: Fri Jun 22 10:49:50 2018 -0400
Committer: Stephen Mallette
Committed: Fri Jun 22 10:49:50 2018 -0400
--
pom.xml | 13 ++---
1 file changed, 10 insertions(+), 3 deletions(-)
--
http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/8363ad56/pom.xml
--
diff --git a/pom.xml b/pom.xml
index 155db82..d13f60e 100644
--- a/pom.xml
+++ b/pom.xml
@@ -866,11 +866,18 @@ limitations under the License.
-
${asciidoc.input.dir}/
-
${htmlsingle.output.dir}/
-
${asciidoc.input.dir}/static/*.*
+
${asciidoc.input.dir}
+
${htmlsingle.output.dir}
+
+
index.asciidoc
+
+
+
${asciidoc.input.dir}/static/*.*
+
+
${asciidoc.input.dir}
+
${htmlsingle.output.dir}
index.asciidoc
html5
article
[1/4] tinkerpop git commit: Fixed a problem where index.asciidoc wasn't processing to html right CTR
Repository: tinkerpop
Updated Branches:
refs/heads/master c18582d2a -> 9b3ffe9f0
Fixed a problem where index.asciidoc wasn't processing to html right CTR
Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo
Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/8363ad56
Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/8363ad56
Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/8363ad56
Branch: refs/heads/master
Commit: 8363ad560a4a9e679d401b051952a1856ce570c0
Parents: aef2f6c
Author: Stephen Mallette
Authored: Fri Jun 22 10:49:50 2018 -0400
Committer: Stephen Mallette
Committed: Fri Jun 22 10:49:50 2018 -0400
--
pom.xml | 13 ++---
1 file changed, 10 insertions(+), 3 deletions(-)
--
http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/8363ad56/pom.xml
--
diff --git a/pom.xml b/pom.xml
index 155db82..d13f60e 100644
--- a/pom.xml
+++ b/pom.xml
@@ -866,11 +866,18 @@ limitations under the License.
-
${asciidoc.input.dir}/
-
${htmlsingle.output.dir}/
-
${asciidoc.input.dir}/static/*.*
+
${asciidoc.input.dir}
+
${htmlsingle.output.dir}
+
+
index.asciidoc
+
+
+
${asciidoc.input.dir}/static/*.*
+
+
${asciidoc.input.dir}
+
${htmlsingle.output.dir}
index.asciidoc
html5
article
[1/3] tinkerpop git commit: Fixed a problem where index.asciidoc wasn't processing to html right CTR
Repository: tinkerpop
Updated Branches:
refs/heads/tp33 1309777d7 -> 49730704e
Fixed a problem where index.asciidoc wasn't processing to html right CTR
Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo
Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/8363ad56
Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/8363ad56
Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/8363ad56
Branch: refs/heads/tp33
Commit: 8363ad560a4a9e679d401b051952a1856ce570c0
Parents: aef2f6c
Author: Stephen Mallette
Authored: Fri Jun 22 10:49:50 2018 -0400
Committer: Stephen Mallette
Committed: Fri Jun 22 10:49:50 2018 -0400
--
pom.xml | 13 ++---
1 file changed, 10 insertions(+), 3 deletions(-)
--
http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/8363ad56/pom.xml
--
diff --git a/pom.xml b/pom.xml
index 155db82..d13f60e 100644
--- a/pom.xml
+++ b/pom.xml
@@ -866,11 +866,18 @@ limitations under the License.
-
${asciidoc.input.dir}/
-
${htmlsingle.output.dir}/
-
${asciidoc.input.dir}/static/*.*
+
${asciidoc.input.dir}
+
${htmlsingle.output.dir}
+
+
index.asciidoc
+
+
+
${asciidoc.input.dir}/static/*.*
+
+
${asciidoc.input.dir}
+
${htmlsingle.output.dir}
index.asciidoc
html5
article
[2/2] tinkerpop git commit: Added practical gremlin logo to doc listing CTR
Added practical gremlin logo to doc listing CTR Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/32aebb8f Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/32aebb8f Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/32aebb8f Branch: refs/heads/tp32 Commit: 32aebb8f021673c2a58778ecced05ff6370302cc Parents: 8363ad5 Author: Stephen Mallette Authored: Fri Jun 22 10:49:59 2018 -0400 Committer: Stephen Mallette Committed: Fri Jun 22 10:49:59 2018 -0400 -- docs/src/index.asciidoc | 2 +- docs/static/images/practical-gremlin.png | Bin 0 -> 392179 bytes 2 files changed, 1 insertion(+), 1 deletion(-) -- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/32aebb8f/docs/src/index.asciidoc -- diff --git a/docs/src/index.asciidoc b/docs/src/index.asciidoc index f07bd99..90852e6 100644 --- a/docs/src/index.asciidoc +++ b/docs/src/index.asciidoc @@ -70,7 +70,7 @@ A brief overview of RDBMS architecture in comparison to graph, basic graph termi and an overview of Gremlin. (*external*) ^|image:gremlin-compendium.png[width=200] |link:http://www.doanduyhai.com/blog/?p=13460[The Gremlin Compendium, minimum survival kit for any Gremlin user] + A series of blog posts that examine the Gremlin language in the context of various graph traversal patterns. (*external*) -^|image:gremlin-running.png[width=125] |link:http://kelvinlawrence.net/book/Gremlin-Graph-Guide.html[Graph Databases, Gremlin and TinkerPop: A Tutorial] + +^|image:practical-gremlin.png[width=200] |link:http://kelvinlawrence.net/book/Gremlin-Graph-Guide.html[Practical Gremlin: An Apache TinkerPop Tutorial] + A getting started guide for users of graph databases and the Gremlin query language featuring hints, tips and sample queries. (*external*) |= http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/32aebb8f/docs/static/images/practical-gremlin.png -- diff --git a/docs/static/images/practical-gremlin.png b/docs/static/images/practical-gremlin.png new file mode 100755 index 000..f080e65 Binary files /dev/null and b/docs/static/images/practical-gremlin.png differ
[2/3] tinkerpop git commit: Added practical gremlin logo to doc listing CTR
Added practical gremlin logo to doc listing CTR Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/32aebb8f Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/32aebb8f Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/32aebb8f Branch: refs/heads/tp33 Commit: 32aebb8f021673c2a58778ecced05ff6370302cc Parents: 8363ad5 Author: Stephen Mallette Authored: Fri Jun 22 10:49:59 2018 -0400 Committer: Stephen Mallette Committed: Fri Jun 22 10:49:59 2018 -0400 -- docs/src/index.asciidoc | 2 +- docs/static/images/practical-gremlin.png | Bin 0 -> 392179 bytes 2 files changed, 1 insertion(+), 1 deletion(-) -- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/32aebb8f/docs/src/index.asciidoc -- diff --git a/docs/src/index.asciidoc b/docs/src/index.asciidoc index f07bd99..90852e6 100644 --- a/docs/src/index.asciidoc +++ b/docs/src/index.asciidoc @@ -70,7 +70,7 @@ A brief overview of RDBMS architecture in comparison to graph, basic graph termi and an overview of Gremlin. (*external*) ^|image:gremlin-compendium.png[width=200] |link:http://www.doanduyhai.com/blog/?p=13460[The Gremlin Compendium, minimum survival kit for any Gremlin user] + A series of blog posts that examine the Gremlin language in the context of various graph traversal patterns. (*external*) -^|image:gremlin-running.png[width=125] |link:http://kelvinlawrence.net/book/Gremlin-Graph-Guide.html[Graph Databases, Gremlin and TinkerPop: A Tutorial] + +^|image:practical-gremlin.png[width=200] |link:http://kelvinlawrence.net/book/Gremlin-Graph-Guide.html[Practical Gremlin: An Apache TinkerPop Tutorial] + A getting started guide for users of graph databases and the Gremlin query language featuring hints, tips and sample queries. (*external*) |= http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/32aebb8f/docs/static/images/practical-gremlin.png -- diff --git a/docs/static/images/practical-gremlin.png b/docs/static/images/practical-gremlin.png new file mode 100755 index 000..f080e65 Binary files /dev/null and b/docs/static/images/practical-gremlin.png differ
[4/4] tinkerpop git commit: Merge branch 'tp33'
Merge branch 'tp33' Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/9b3ffe9f Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/9b3ffe9f Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/9b3ffe9f Branch: refs/heads/master Commit: 9b3ffe9f0ab4f37ca823e78974f817c5a2e200ff Parents: c18582d 4973070 Author: Stephen Mallette Authored: Fri Jun 22 10:51:44 2018 -0400 Committer: Stephen Mallette Committed: Fri Jun 22 10:51:44 2018 -0400 -- docs/src/index.asciidoc | 2 +- docs/static/images/practical-gremlin.png | Bin 0 -> 392179 bytes pom.xml | 13 ++--- 3 files changed, 11 insertions(+), 4 deletions(-) -- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/9b3ffe9f/pom.xml --
[3/4] tinkerpop git commit: Merge branch 'tp32' into tp33
Merge branch 'tp32' into tp33 Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/49730704 Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/49730704 Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/49730704 Branch: refs/heads/master Commit: 49730704e3c840f089b674faece506d9a6ab3a69 Parents: 1309777 32aebb8 Author: Stephen Mallette Authored: Fri Jun 22 10:51:33 2018 -0400 Committer: Stephen Mallette Committed: Fri Jun 22 10:51:33 2018 -0400 -- docs/src/index.asciidoc | 2 +- docs/static/images/practical-gremlin.png | Bin 0 -> 392179 bytes pom.xml | 13 ++--- 3 files changed, 11 insertions(+), 4 deletions(-) -- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/49730704/pom.xml --
tinkerpop git commit: Added practical gremlin logo
Repository: tinkerpop Updated Branches: refs/heads/master b5bae4c9c -> c18582d2a Added practical gremlin logo Put logo and link on home page replacing the old Getting Started logo. https://lists.apache.org/thread.html/14d31ed24d7618253ba34cb0735c28f59b87096126d04242caa149bb@%3Cdev.tinkerpop.apache.org%3E CTR Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/c18582d2 Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/c18582d2 Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/c18582d2 Branch: refs/heads/master Commit: c18582d2a1858b54d993053d1ba47d08c8b61b84 Parents: b5bae4c Author: Stephen Mallette Authored: Fri Jun 22 10:42:44 2018 -0400 Committer: Stephen Mallette Committed: Fri Jun 22 10:42:44 2018 -0400 -- docs/site/home/img/practical-gremlin-titled.png | Bin 0 -> 412544 bytes docs/site/home/index.html | 4 ++-- docs/site/home/template/header-footer.html | 3 +++ 3 files changed, 5 insertions(+), 2 deletions(-) -- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/c18582d2/docs/site/home/img/practical-gremlin-titled.png -- diff --git a/docs/site/home/img/practical-gremlin-titled.png b/docs/site/home/img/practical-gremlin-titled.png new file mode 100755 index 000..265f3a2 Binary files /dev/null and b/docs/site/home/img/practical-gremlin-titled.png differ http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/c18582d2/docs/site/home/index.html -- diff --git a/docs/site/home/index.html b/docs/site/home/index.html index d882049..e67306e 100644 --- a/docs/site/home/index.html +++ b/docs/site/home/index.html @@ -47,8 +47,8 @@ limitations under the License. - http://tinkerpop.apache.org/docs/current/tutorials/getting-started;> - + http://kelvinlawrence.net/book/Gremlin-Graph-Guide.html;> + http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/c18582d2/docs/site/home/template/header-footer.html -- diff --git a/docs/site/home/template/header-footer.html b/docs/site/home/template/header-footer.html index b49ed42..ef86a3c 100644 --- a/docs/site/home/template/header-footer.html +++ b/docs/site/home/template/header-footer.html @@ -100,6 +100,9 @@ limitations under the License. http://tinkerpop.apache.org/docs/current/tutorials/the-gremlin-console/;>The Gremlin Console http://tinkerpop.apache.org/docs/current/recipes/;>Gremlin Recipes http://tinkerpop.apache.org/docs/current/tutorials/gremlin-language-variants/;>Gremlin Language Variants + http://tinkerpop.apache.org/docs/current/tutorials/gremlins-anatomy/;>Gremlin's Anatomy + + http://kelvinlawrence.net/book/Gremlin-Graph-Guide.html;>Book: Practical Gremlin by Kelvin Lawrence http://sql2gremlin.com/;>SQL2Gremlin
[2/2] tinkerpop git commit: Merge branch 'tp32' into tp33
Merge branch 'tp32' into tp33 Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/1309777d Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/1309777d Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/1309777d Branch: refs/heads/tp33 Commit: 1309777d7772818ef0810182a09a30503eeefef8 Parents: e1ef8b6 aef2f6c Author: Stephen Mallette Authored: Fri Jun 22 08:31:53 2018 -0400 Committer: Stephen Mallette Committed: Fri Jun 22 08:31:53 2018 -0400 -- docs/src/reference/the-traversal.asciidoc | 19 +++ 1 file changed, 19 insertions(+) -- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/1309777d/docs/src/reference/the-traversal.asciidoc --
tinkerpop git commit: Clarification around random walks CTR
Repository: tinkerpop
Updated Branches:
refs/heads/tp32 7c7dddb72 -> aef2f6ca0
Clarification around random walks CTR
Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo
Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/aef2f6ca
Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/aef2f6ca
Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/aef2f6ca
Branch: refs/heads/tp32
Commit: aef2f6ca0f8f1f62cb8220b01afc49d70714692f
Parents: 7c7dddb
Author: Stephen Mallette
Authored: Fri Jun 22 08:31:16 2018 -0400
Committer: Stephen Mallette
Committed: Fri Jun 22 08:31:16 2018 -0400
--
docs/src/reference/the-traversal.asciidoc | 19 +++
1 file changed, 19 insertions(+)
--
http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/aef2f6ca/docs/src/reference/the-traversal.asciidoc
--
diff --git a/docs/src/reference/the-traversal.asciidoc
b/docs/src/reference/the-traversal.asciidoc
index b600b7a..8cc6ac0 100644
--- a/docs/src/reference/the-traversal.asciidoc
+++ b/docs/src/reference/the-traversal.asciidoc
@@ -2191,6 +2191,25 @@ g.V(1).repeat(local(
)).times(10).path()
+As a clarification, note that in the above example `local()` is not strictly
required as it only does the random walk
+over a single vertex, but note what happens without it if multiple vertices
are traversed:
+
+[gremlin-groovy,modern]
+
+g.V().repeat(bothE().sample(1).by('weight').otherV()).times(5).path()
+
+
+The use of `local()` ensures that the traversal over `bothE()` occurs once per
vertex traverser that passes through,
+thus allowing one random walk per vertex.
+
+[gremlin-groovy,modern]
+
+g.V().repeat(local(bothE().sample(1).by('weight').otherV())).times(5).path()
+
+
+So, while not strictly required, it is likely better to be explicit with the
use of `local()` so that the proper intent
+of the traversal is expressed.
+
*Additional References*
link:++http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#sample-int-++[`sample(int)`],
[2/3] tinkerpop git commit: Merge branch 'tp32' into tp33
Merge branch 'tp32' into tp33 Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/1309777d Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/1309777d Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/1309777d Branch: refs/heads/master Commit: 1309777d7772818ef0810182a09a30503eeefef8 Parents: e1ef8b6 aef2f6c Author: Stephen Mallette Authored: Fri Jun 22 08:31:53 2018 -0400 Committer: Stephen Mallette Committed: Fri Jun 22 08:31:53 2018 -0400 -- docs/src/reference/the-traversal.asciidoc | 19 +++ 1 file changed, 19 insertions(+) -- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/1309777d/docs/src/reference/the-traversal.asciidoc --
[1/2] tinkerpop git commit: Clarification around random walks CTR
Repository: tinkerpop
Updated Branches:
refs/heads/tp33 e1ef8b623 -> 1309777d7
Clarification around random walks CTR
Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo
Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/aef2f6ca
Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/aef2f6ca
Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/aef2f6ca
Branch: refs/heads/tp33
Commit: aef2f6ca0f8f1f62cb8220b01afc49d70714692f
Parents: 7c7dddb
Author: Stephen Mallette
Authored: Fri Jun 22 08:31:16 2018 -0400
Committer: Stephen Mallette
Committed: Fri Jun 22 08:31:16 2018 -0400
--
docs/src/reference/the-traversal.asciidoc | 19 +++
1 file changed, 19 insertions(+)
--
http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/aef2f6ca/docs/src/reference/the-traversal.asciidoc
--
diff --git a/docs/src/reference/the-traversal.asciidoc
b/docs/src/reference/the-traversal.asciidoc
index b600b7a..8cc6ac0 100644
--- a/docs/src/reference/the-traversal.asciidoc
+++ b/docs/src/reference/the-traversal.asciidoc
@@ -2191,6 +2191,25 @@ g.V(1).repeat(local(
)).times(10).path()
+As a clarification, note that in the above example `local()` is not strictly
required as it only does the random walk
+over a single vertex, but note what happens without it if multiple vertices
are traversed:
+
+[gremlin-groovy,modern]
+
+g.V().repeat(bothE().sample(1).by('weight').otherV()).times(5).path()
+
+
+The use of `local()` ensures that the traversal over `bothE()` occurs once per
vertex traverser that passes through,
+thus allowing one random walk per vertex.
+
+[gremlin-groovy,modern]
+
+g.V().repeat(local(bothE().sample(1).by('weight').otherV())).times(5).path()
+
+
+So, while not strictly required, it is likely better to be explicit with the
use of `local()` so that the proper intent
+of the traversal is expressed.
+
*Additional References*
link:++http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#sample-int-++[`sample(int)`],
[3/3] tinkerpop git commit: Merge branch 'tp33'
Merge branch 'tp33' Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/b5bae4c9 Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/b5bae4c9 Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/b5bae4c9 Branch: refs/heads/master Commit: b5bae4c9cb1c7da3e9c1df82ed733a0691d6e0fb Parents: b5600e7 1309777 Author: Stephen Mallette Authored: Fri Jun 22 08:32:05 2018 -0400 Committer: Stephen Mallette Committed: Fri Jun 22 08:32:05 2018 -0400 -- docs/src/reference/the-traversal.asciidoc | 19 +++ 1 file changed, 19 insertions(+) -- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/b5bae4c9/docs/src/reference/the-traversal.asciidoc --
[1/3] tinkerpop git commit: Clarification around random walks CTR
Repository: tinkerpop
Updated Branches:
refs/heads/master b5600e772 -> b5bae4c9c
Clarification around random walks CTR
Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo
Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/aef2f6ca
Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/aef2f6ca
Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/aef2f6ca
Branch: refs/heads/master
Commit: aef2f6ca0f8f1f62cb8220b01afc49d70714692f
Parents: 7c7dddb
Author: Stephen Mallette
Authored: Fri Jun 22 08:31:16 2018 -0400
Committer: Stephen Mallette
Committed: Fri Jun 22 08:31:16 2018 -0400
--
docs/src/reference/the-traversal.asciidoc | 19 +++
1 file changed, 19 insertions(+)
--
http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/aef2f6ca/docs/src/reference/the-traversal.asciidoc
--
diff --git a/docs/src/reference/the-traversal.asciidoc
b/docs/src/reference/the-traversal.asciidoc
index b600b7a..8cc6ac0 100644
--- a/docs/src/reference/the-traversal.asciidoc
+++ b/docs/src/reference/the-traversal.asciidoc
@@ -2191,6 +2191,25 @@ g.V(1).repeat(local(
)).times(10).path()
+As a clarification, note that in the above example `local()` is not strictly
required as it only does the random walk
+over a single vertex, but note what happens without it if multiple vertices
are traversed:
+
+[gremlin-groovy,modern]
+
+g.V().repeat(bothE().sample(1).by('weight').otherV()).times(5).path()
+
+
+The use of `local()` ensures that the traversal over `bothE()` occurs once per
vertex traverser that passes through,
+thus allowing one random walk per vertex.
+
+[gremlin-groovy,modern]
+
+g.V().repeat(local(bothE().sample(1).by('weight').otherV())).times(5).path()
+
+
+So, while not strictly required, it is likely better to be explicit with the
use of `local()` so that the proper intent
+of the traversal is expressed.
+
*Additional References*
link:++http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#sample-int-++[`sample(int)`],
