Skip to content

Commit 896a40c

Browse files
actions-useractions-user
committed
Update documentation
1 parent 9225bcc commit 896a40c

7 files changed

Lines changed: 38 additions & 22 deletions

File tree

‎how-to/demo_modules/__init__/index.html‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2942,7 +2942,7 @@ <h1> init </h1>
29422942
</style>
29432943
<!-- End of mermaid configuration --><div class="jupyter-wrapper">
29442944
<div class="jp-Notebook" data-jp-theme-light="true" data-jp-theme-name="JupyterLab Light">
2945-
<div class="jp-Cell jp-MarkdownCell jp-Notebook-cell" id="cell-id=08653612">
2945+
<div class="jp-Cell jp-MarkdownCell jp-Notebook-cell" id="cell-id=ceb1e8bd">
29462946
<div class="jp-Cell-inputWrapper" tabindex="0">
29472947
<div class="jp-Collapser jp-InputCollapser jp-Cell-inputCollapser">
29482948
</div>

‎how-to/demo_modules/acquisition/index.html‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2943,7 +2943,7 @@ <h1>Acquisition</h1>
29432943
<!-- End of mermaid configuration --><div class="jupyter-wrapper">
29442944
<div class="jp-Notebook" data-jp-theme-light="true" data-jp-theme-name="JupyterLab Light">
29452945
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs">
2946-
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=ca9f302f">
2946+
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=7560800e">
29472947
<div class="jp-Cell-inputWrapper" tabindex="0">
29482948
<div class="jp-Collapser jp-InputCollapser jp-Cell-inputCollapser">
29492949
</div>
@@ -2982,7 +2982,7 @@ <h1>Acquisition</h1>
29822982
</div>
29832983
</div>
29842984
</div><div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs">
2985-
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=329b8958">
2985+
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=abd03b9d">
29862986
<div class="jp-Cell-inputWrapper" tabindex="0">
29872987
<div class="jp-Collapser jp-InputCollapser jp-Cell-inputCollapser">
29882988
</div>
@@ -3011,7 +3011,7 @@ <h1>Acquisition</h1>
30113011
</div>
30123012
</div>
30133013
</div><div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs">
3014-
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=d0778914">
3014+
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=f4fcc5a0">
30153015
<div class="jp-Cell-inputWrapper" tabindex="0">
30163016
<div class="jp-Collapser jp-InputCollapser jp-Cell-inputCollapser">
30173017
</div>
@@ -3050,7 +3050,7 @@ <h1>Acquisition</h1>
30503050
</div>
30513051
</div>
30523052
</div><div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs">
3053-
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=f842245a">
3053+
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=d03f4522">
30543054
<div class="jp-Cell-inputWrapper" tabindex="0">
30553055
<div class="jp-Collapser jp-InputCollapser jp-Cell-inputCollapser">
30563056
</div>
@@ -3093,7 +3093,7 @@ <h1>Acquisition</h1>
30933093
</div>
30943094
</div>
30953095
</div><div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs">
3096-
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=c4735f95">
3096+
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=d6cb9dda">
30973097
<div class="jp-Cell-inputWrapper" tabindex="0">
30983098
<div class="jp-Collapser jp-InputCollapser jp-Cell-inputCollapser">
30993099
</div>

‎how-to/demo_modules/analysis/index.html‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2943,7 +2943,7 @@ <h1>Analysis</h1>
29432943
<!-- End of mermaid configuration --><div class="jupyter-wrapper">
29442944
<div class="jp-Notebook" data-jp-theme-light="true" data-jp-theme-name="JupyterLab Light">
29452945
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs">
2946-
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=415f6bca">
2946+
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=cbe6774f">
29472947
<div class="jp-Cell-inputWrapper" tabindex="0">
29482948
<div class="jp-Collapser jp-InputCollapser jp-Cell-inputCollapser">
29492949
</div>
@@ -2984,7 +2984,7 @@ <h1>Analysis</h1>
29842984
</div>
29852985
</div>
29862986
</div><div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs">
2987-
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=07c72e23">
2987+
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=a204a37e">
29882988
<div class="jp-Cell-inputWrapper" tabindex="0">
29892989
<div class="jp-Collapser jp-InputCollapser jp-Cell-inputCollapser">
29902990
</div>
@@ -3013,7 +3013,7 @@ <h1>Analysis</h1>
30133013
</div>
30143014
</div>
30153015
</div><div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs">
3016-
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=f9caf118">
3016+
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=ef99b070">
30173017
<div class="jp-Cell-inputWrapper" tabindex="0">
30183018
<div class="jp-Collapser jp-InputCollapser jp-Cell-inputCollapser">
30193019
</div>
@@ -3054,7 +3054,7 @@ <h1>Analysis</h1>
30543054
</div>
30553055
</div>
30563056
</div><div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs">
3057-
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=16ced319">
3057+
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=10e569cd">
30583058
<div class="jp-Cell-inputWrapper" tabindex="0">
30593059
<div class="jp-Collapser jp-InputCollapser jp-Cell-inputCollapser">
30603060
</div>
@@ -3103,7 +3103,7 @@ <h1>Analysis</h1>
31033103
</div>
31043104
</div>
31053105
</div><div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs">
3106-
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=45755ff9">
3106+
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=47a7a4a7">
31073107
<div class="jp-Cell-inputWrapper" tabindex="0">
31083108
<div class="jp-Collapser jp-InputCollapser jp-Cell-inputCollapser">
31093109
</div>

‎how-to/demo_modules/processing/index.html‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2943,7 +2943,7 @@ <h1>Processing</h1>
29432943
<!-- End of mermaid configuration --><div class="jupyter-wrapper">
29442944
<div class="jp-Notebook" data-jp-theme-light="true" data-jp-theme-name="JupyterLab Light">
29452945
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs">
2946-
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=ce5f5c45">
2946+
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=3f0c9524">
29472947
<div class="jp-Cell-inputWrapper" tabindex="0">
29482948
<div class="jp-Collapser jp-InputCollapser jp-Cell-inputCollapser">
29492949
</div>
@@ -2984,7 +2984,7 @@ <h1>Processing</h1>
29842984
</div>
29852985
</div>
29862986
</div><div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs">
2987-
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=5d1139a4">
2987+
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=f355fc2d">
29882988
<div class="jp-Cell-inputWrapper" tabindex="0">
29892989
<div class="jp-Collapser jp-InputCollapser jp-Cell-inputCollapser">
29902990
</div>
@@ -3013,7 +3013,7 @@ <h1>Processing</h1>
30133013
</div>
30143014
</div>
30153015
</div><div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs">
3016-
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=8d53123f">
3016+
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=319a3d67">
30173017
<div class="jp-Cell-inputWrapper" tabindex="0">
30183018
<div class="jp-Collapser jp-InputCollapser jp-Cell-inputCollapser">
30193019
</div>
@@ -3056,7 +3056,7 @@ <h1>Processing</h1>
30563056
</div>
30573057
</div>
30583058
</div><div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs">
3059-
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=f69dd9ce">
3059+
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=d2864c6b">
30603060
<div class="jp-Cell-inputWrapper" tabindex="0">
30613061
<div class="jp-Collapser jp-InputCollapser jp-Cell-inputCollapser">
30623062
</div>
@@ -3105,7 +3105,7 @@ <h1>Processing</h1>
31053105
</div>
31063106
</div>
31073107
</div><div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs">
3108-
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=01ccc6bb">
3108+
<div class="jp-Cell jp-CodeCell jp-Notebook-cell jp-mod-noOutputs" id="cell-id=73db9f56">
31093109
<div class="jp-Cell-inputWrapper" tabindex="0">
31103110
<div class="jp-Collapser jp-InputCollapser jp-Cell-inputCollapser">
31113111
</div>

‎llms-full.txt‎

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# DataJoint Documentation (Full)
22

3-
Generated: 2026-02-04 14:47:26 UTC
3+
Generated: 2026-02-04 14:49:36 UTC
44
Commit: unknown
55
Branch: unknown
66

@@ -30849,14 +30849,24 @@ result = A.join(B, semantic_check=True, left=False)
3084930849

3085030850
### 4.3 Join Condition
3085130851

30852-
Joins match on all shared non-hidden attributes (namesakes):
30852+
With `semantic_check=True` (default), joins match only on **homologous namesakes**—attributes with the same name AND same lineage (traced through foreign keys to the same original definition):
3085330853

3085430854
```python
30855-
# If Session has (subject_id, session_id) and Trial has (subject_id, session_id, trial_id)
30855+
# Session has (subject_id, session_id) and Trial has (subject_id, session_id, trial_id)
30856+
# Both subject_id attributes trace to Subject.subject_id via foreign keys
3085630857
# Join matches on (subject_id, session_id)
3085730858
Session * Trial
3085830859
```
3085930860

30861+
With `semantic_check=False`, joins match on **all namesakes** regardless of lineage (natural join):
30862+
30863+
```python
30864+
# Match on any shared attribute names, ignoring lineage
30865+
A.join(B, semantic_check=False)
30866+
```
30867+
30868+
See [Section 9: Semantic Matching](#9-semantic-matching) for details on attribute lineage.
30869+
3086030870
### 4.4 Primary Key Determination
3086130871

3086230872
The result's primary key depends on functional dependencies:

‎reference/specs/query-algebra/index.html‎

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8172,11 +8172,17 @@ <h3 id="42-parameters">4.2 Parameters<a class="headerlink" href="#42-parameters"
81728172
</tbody>
81738173
</table>
81748174
<h3 id="43-join-condition">4.3 Join Condition<a class="headerlink" href="#43-join-condition" title="Permanent link">&para;</a></h3>
8175-
<p>Joins match on all shared non-hidden attributes (namesakes):</p>
8176-
<div class="highlight"><pre><span></span><code><span class="c1"># If Session has (subject_id, session_id) and Trial has (subject_id, session_id, trial_id)</span>
8175+
<p>With <code>semantic_check=True</code> (default), joins match only on <strong>homologous namesakes</strong>—attributes with the same name AND same lineage (traced through foreign keys to the same original definition):</p>
8176+
<div class="highlight"><pre><span></span><code><span class="c1"># Session has (subject_id, session_id) and Trial has (subject_id, session_id, trial_id)</span>
8177+
<span class="c1"># Both subject_id attributes trace to Subject.subject_id via foreign keys</span>
81778178
<span class="c1"># Join matches on (subject_id, session_id)</span>
81788179
<span class="n">Session</span> <span class="o">*</span> <span class="n">Trial</span>
81798180
</code></pre></div>
8181+
<p>With <code>semantic_check=False</code>, joins match on <strong>all namesakes</strong> regardless of lineage (natural join):</p>
8182+
<div class="highlight"><pre><span></span><code><span class="c1"># Match on any shared attribute names, ignoring lineage</span>
8183+
<span class="n">A</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">B</span><span class="p">,</span> <span class="n">semantic_check</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
8184+
</code></pre></div>
8185+
<p>See <a href="#9-semantic-matching">Section 9: Semantic Matching</a> for details on attribute lineage.</p>
81808186
<h3 id="44-primary-key-determination">4.4 Primary Key Determination<a class="headerlink" href="#44-primary-key-determination" title="Permanent link">&para;</a></h3>
81818187
<p>The result's primary key depends on functional dependencies:</p>
81828188
<table>

‎search/search_index.json‎

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)