NB: This is a temporary working document under continual revision as coding progresses. The documents and the initial implementation are co-evolving continually, so expect to find some duplications and occasional inconsistencies (all of which will be removed over time). (See page footer for most recent revision.)
In an attempt to minimize the number of inodes required, a number of the variables are amalgamated into JSON structures.
The directory in which an entity is embodied may therefore contain as few as the following files:
NB, in versions up to 0.16, variables (accounts) were represented in a JSON file named .value the type of which was identified by a field named "type". In order to reduce the time (and energy) wasted unpacking/packing JSON files, the .value file has been replaced with a mutually exclusive collection of files the names of which identify the type. Whatever the type, its contents are replicated in the .history file of the currency and that of the agent accounts affected (the payer and the payee in the case of a payment) for each transaction.
These variable files include (but are not limited to):
.v_integer
A simple text representation of a signed integer.
e.g.
-12345
.v_count
A simple text representation of a positive integer.
e.g.
12345
.v_balance
Another simple text representation of an integer, with an implicit decimal separator.
e.g.
-12345
forces display as "-£123.45"
.v_real
A simple text representation of a real number to arbitrary precision.
e.g.
123.4567
or
-1.234567e2
.v_complex
A simple text representation of a real number to arbitrary precision, on two lines. (This is probably not needed but is included here for completeness.)
e.g.
123.4567
3.145926
representing: 123.4567+i3.145926
.v_vector
An array of real numbers, each represented as a simple text string, one value per line.
e.g.
123.4567
3.145926
-273.15
0.00892
representing: [123.4567, 3.145926, -273.15, 0.00892]
.v_matrix
A simple matrix of real numbers represented as JSON.
e.g.
[[12.4,3.14,-2.15],[0.0,1.5,3.9],[-9.5,4.3,8.0]]
representing
$$ \left[
\begin{matrix}
12.4 & 3.14 & -2.15 \\
0.0 & 1.5 & 3.9 \\
-9.5 & 4.3 & 8.0 \\
\end{matrix}
\right]$$
NB: The descriptions below have not yet been fully updated.
.v_impact_vector
An array of real numbers, each represented as a string, along with a an array of the same length containing (in a one-to-one correspondence by index) a string assigning a significance to each value.
An impact vector is "elastic" in that a new value:significance pair can be inserted at any stage in its cumulative recording of impact data. Any such insertion requires a corresponding adjustment to any associated mapping matrix (which is not a trivial undertaking). A list of all mapping matrices associated with each impact vector is stored in an FPH array.
e.g.
{
"value": [],
"significance_map": [],
"associated_mapping_matrices": []
}
.v_weighting_matrix
A matrix of real numbers, each represented as a string, along with a matrix of the same dimension containing (in one-to-one correspondence by index pair) a string assigning a significance to each weighting value.
This used to map an impact vector of length N to another of length M (M ≤ N), either for use in a decision-guidance array or in preparation for further subsequent expansion of the impact data set.
A list of all impact vectors associated with a mapping matrix is stored in an FPH array.
{
"value" : [[]],
"significance_map": [[]],
"associated_impact_vectors": []
}
.v_trigger
{
"data_uri": "",
"action": "",
"threshold": ""
}
.v_time_series
{
"data_uri": "",
"ensemble_span": ""
}
.v_ACP_ratio
A continually-update A:C:P ratio.
1 ≥ P ≥ C ≥ A > 0
1 ≥ A/C > 0
1 ≥ C/P > 0
1 ≥ A/P > 0
{
"A": "",
"C": "",
"P": ""
}
| hrtimestamp | (YYYYMMDDhhmmsss) |
| unixtimestamp | |
| transaction_type | {credit, debit, write, read, assign} |
| subject/payee | FPH |
| actor/payer | FPH |
| value | JSON representation for this currency's type |
| balance | JSON representation for this currency's type |
| volume | JSON representation for this currency's type |
| explanation |