7 lines
12 KiB
HTML
7 lines
12 KiB
HTML
<!DOCTYPE html PUBLIC ""
|
|
"">
|
|
<html><head><meta charset="UTF-8" /><title>wildwood.schema documentation</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name">Wildwood</span> <span class="project-version">0.1.0-SNAPSHOT</span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="AgainstTruth.html"><div class="inner"><span>Against Truth</span></div></a></li><li class="depth-1 "><a href="Analysis.html"><div class="inner"><span>Analysis</span></div></a></li><li class="depth-1 "><a href="Arboretum.html"><div class="inner"><span>Arboretum</span></div></a></li><li class="depth-1 "><a href="Arden.html"><div class="inner"><span>Arden</span></div></a></li><li class="depth-1 "><a href="BatesonKammerer.html"><div class="inner"><span>The Bateson / Kammerer debate</span></div></a></li><li class="depth-1 "><a href="Bialowieza.html"><div class="inner"><span>Bialowieza</span></div></a></li><li class="depth-1 "><a href="Errata.html"><div class="inner"><span>Errata</span></div></a></li><li class="depth-1 "><a href="Experience.html"><div class="inner"><span>Experience</span></div></a></li><li class="depth-1 "><a href="HegemonicArgument.html"><div class="inner"><span>Hegemonic Argument</span></div></a></li><li class="depth-1 "><a href="History.html"><div class="inner"><span>History</span></div></a></li><li class="depth-1 "><a href="HuxleyKropotkin.html"><div class="inner"><span>The Huxley / Kropotkin debate</span></div></a></li><li class="depth-1 "><a href="Implementing.html"><div class="inner"><span>Implementing</span></div></a></li><li class="depth-1 "><a href="JAccuse.html"><div class="inner"><span>J'Accuse</span></div></a></li><li class="depth-1 "><a href="KnacqTools.html"><div class="inner"><span>KnacqTools</span></div></a></li><li class="depth-1 "><a href="Manifesto.html"><div class="inner"><span>Manifesto</span></div></a></li><li class="depth-1 "><a href="OnHylasAndPhilonus.html"><div class="inner"><span>On the First Dialogue of Hylas and Philonous</span></div></a></li><li class="depth-1 "><a href="PredicateSubtext.html"><div class="inner"><span>On the subtext of a predicate</span></div></a></li><li class="depth-1 "><a href="TheProblem.html"><div class="inner"><span>The Problem</span></div></a></li><li class="depth-1 "><a href="intro.html"><div class="inner"><span>Introduction to Wildwood</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>wildwood</span></div></div></li><li class="depth-2 branch"><a href="wildwood.advocate.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>advocate</span></div></a></li><li class="depth-2 branch"><a href="wildwood.bialowieza.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>bialowieza</span></div></a></li><li class="depth-2 branch"><a href="wildwood.caesar.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>caesar</span></div></a></li><li class="depth-2"><div class="no-link"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>dengine</span></div></div></li><li class="depth-3 branch"><a href="wildwood.dengine.engine.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>engine</span></div></a></li><li class="depth-3"><a href="wildwood.dengine.node.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>node</span></div></a></li><li class="depth-2 branch"><a href="wildwood.knowledge-accessor.html"><div class="inner"><span class="tree" style="top: -83px;"><span class="top" style="height: 92px;"></span><span class="bottom"></span></span><span>knowledge-accessor</span></div></a></li><li class="depth-2 branch"><a href="wildwood.mongo-ka.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>mongo-ka</span></div></a></li><li class="depth-2 current"><a href="wildwood.schema.html"><div class="inner"><span class="tree"><span class="top"></span><span class="bottom"></span></span><span>schema</span></div></a></li></ul></div><div class="sidebar secondary"><h3><a href="#top"><span class="inner">Public Vars</span></a></h3><ul><li class="depth-1"><a href="wildwood.schema.html#var-argument-keys"><div class="inner"><span>argument-keys</span></div></a></li><li class="depth-1"><a href="wildwood.schema.html#var-argument.3F"><div class="inner"><span>argument?</span></div></a></li><li class="depth-1"><a href="wildwood.schema.html#var-consensual-keys"><div class="inner"><span>consensual-keys</span></div></a></li><li class="depth-1"><a href="wildwood.schema.html#var-minimise"><div class="inner"><span>minimise</span></div></a></li><li class="depth-1"><a href="wildwood.schema.html#var-preserved-keys"><div class="inner"><span>preserved-keys</span></div></a></li><li class="depth-1"><a href="wildwood.schema.html#var-proposition.3F"><div class="inner"><span>proposition?</span></div></a></li><li class="depth-1"><a href="wildwood.schema.html#var-required-keys"><div class="inner"><span>required-keys</span></div></a></li><li class="depth-1"><a href="wildwood.schema.html#var-rule.3F"><div class="inner"><span>rule?</span></div></a></li><li class="depth-1"><a href="wildwood.schema.html#var-truth"><div class="inner"><span>truth</span></div></a></li></ul></div><div class="namespace-docs" id="content"><h1 class="anchor" id="top">wildwood.schema</h1><div class="doc"><div class="markdown"><p>The knowledge representation. This probably ends up looking a bit like a Toulmin schema, where claims are represented as propositions. There also need to be rules or predicates, things which can test whether a given proposition has a given value. There may be other stuff in here.</p>
|
|
<p>Internal representation of most of this will be as Clojure maps.</p></div></div><div class="public anchor" id="var-argument-keys"><h3>argument-keys</h3><div class="usage"></div><div class="doc"><div class="markdown"><p>Every argument is a proposition, which additionally has these keys.</p></div></div><div class="src-link"><a href="https://github.com/simon-brooke/the-great-game/blob/master/src/wildwood/schema.clj#L26">view source</a></div></div><div class="public anchor" id="var-argument.3F"><h3>argument?</h3><div class="usage"><code>(argument? o)</code></div><div class="doc"><div class="markdown"><p>True if <code>o</code> qualifies as an argument structure.</p>
|
|
<p>An argument structure is a (potentially rich) proposition which, in addition, should have values for <code>:confidence</code> and <code>:authority</code>. A value for <code>:data</code> may, and probably will, also be present but is not required. The value of <code>:confidence</code> must be a number in the range -1 to 1.</p></div></div><div class="src-link"><a href="https://github.com/simon-brooke/the-great-game/blob/master/src/wildwood/schema.clj#L86">view source</a></div></div><div class="public anchor" id="var-consensual-keys"><h3>consensual-keys</h3><div class="usage"></div><div class="doc"><div class="markdown"><p>Every proposition which has these keys, in a given decision process, must have the same semantics and types for their values. The exact representations used for the values of these keys does not matter, it is consensual between all participating advocates in a decision process.</p></div></div><div class="src-link"><a href="https://github.com/simon-brooke/the-great-game/blob/master/src/wildwood/schema.clj#L14">view source</a></div></div><div class="public anchor" id="var-minimise"><h3>minimise</h3><div class="usage"><code>(minimise o)</code></div><div class="doc"><div class="markdown"><p>Expecting that <code>o</code> is a (potentially rich) proposition, return a map identical to <code>o</code> save that for each value <code>v</code> of key <code>k</code> in <code>o</code>, if <code>v</code> is a map and <code>k</code> is not a member of <code>argument-keys</code>, then the returned map shall substitute the value of <code>(:id v)</code>.</p>
|
|
<p>see also <code>wildwood.knowledge-access/maximise</code>.</p></div></div><div class="src-link"><a href="https://github.com/simon-brooke/the-great-game/blob/master/src/wildwood/schema.clj#L102">view source</a></div></div><div class="public anchor" id="var-preserved-keys"><h3>preserved-keys</h3><div class="usage"></div><div class="doc"><div class="markdown"><p>Keys whose values should not be minimised during proposition minimisation</p></div></div><div class="src-link"><a href="https://github.com/simon-brooke/the-great-game/blob/master/src/wildwood/schema.clj#L32">view source</a></div></div><div class="public anchor" id="var-proposition.3F"><h3>proposition?</h3><div class="usage"><code>(proposition? o)</code><code>(proposition? o minimised)</code></div><div class="doc"><div class="markdown"><p>True if <code>o</code> qualifies as a proposition. A proposition is probably a map with some privileged keys, and may look something like a minimised <code>the-great-game.gossip.news-items</code> item.</p>
|
|
<p>If <code>minimised</code> is passed and is <code>true</code>, then the proposition must be minimised - that is to say, the values of keys in a proposition map may not themselves be keys. Where the value of a key represents an object in the world, that value must be simply the <code>id</code> of the object, not a richer representation.</p></div></div><div class="src-link"><a href="https://github.com/simon-brooke/the-great-game/blob/master/src/wildwood/schema.clj#L37">view source</a></div></div><div class="public anchor" id="var-required-keys"><h3>required-keys</h3><div class="usage"></div><div class="doc"><div class="markdown"><p>Every proposition is expected to have values for these keys.</p></div></div><div class="src-link"><a href="https://github.com/simon-brooke/the-great-game/blob/master/src/wildwood/schema.clj#L10">view source</a></div></div><div class="public anchor" id="var-rule.3F"><h3>rule?</h3><div class="usage"><code>(rule? o)</code></div><div class="doc"><div class="markdown"><p>True if <code>o</code> qualifies as a rule. A rule is a structure which comprises * an id and * a function of two arguments, a proposition and a knowledge accessor, and which should (if this can simply be checked) return an argument structure.</p></div></div><div class="src-link"><a href="https://github.com/simon-brooke/the-great-game/blob/master/src/wildwood/schema.clj#L75">view source</a></div></div><div class="public anchor" id="var-truth"><h3>truth</h3><div class="usage"><code>(truth p)</code></div><div class="doc"><div class="markdown"><p>If <code>p</code> is a proposition, return whether the value asserted by that proposition is <code>true</code>. If the <code>:truth</code> key is missing, <code>true</code> is assumed.</p></div></div><div class="src-link"><a href="https://github.com/simon-brooke/the-great-game/blob/master/src/wildwood/schema.clj#L61">view source</a></div></div></div></body></html> |