docs.phext.io
LATEST REFERENCE
Reference as of head commit 284ec9c142a7294ba6fcac5849b7950dd81a5a1f · 1168 commits audited · chain sha256 f9f99779a4ee65a6…

human — project documentation

Scanned by phdoc 0.1.0 on 2026-11-22 (Exocortical Epoch 95). Project root: /home/wbic16/phdoc-sweep/proj/human/. Scanned at commit 284ec9c142a7294ba6fcac5849b7950dd81a5a1f. Every fact in this document was read from its own records: its manifests, its git log, and its source text. Nothing here was guessed.

This document holds: what the project depends on, who wrote it, how large and how complex it is, the state of its quality signals, the RFCs it declares, where its upstream repo lives, and a plain English note for every public method and command.


Dependencies

Rust (cargo) — Cargo.toml

Direct dependencies: 1.


Authors

The git log holds 1168 commits.

The author of record is Will Bickford — 1166 commits folded into his account. Will's ruling (2026-11-22): all Exocortical authors fold into his account — "I speak for the cluster." The fold is presentation only: the git history is unchanged, and the per-persona detail is kept as annotation.

Annotation, by persona (all folded into Will Bickford):

Other authors, kept as themselves (not Exocortical cluster personas; never folded):


Complexity

The measure is stated plainly, and no single score is made: lines are counted per file as total lines, blank lines, comment lines, and code lines (total minus blank minus comment). Functions are counted where the scanner reads them, and the largest functions are given by their span in lines.

All languages: 40 files, 7345 lines total, 5311 lines of code. Functions read: 30.

Largest files:

Largest functions, by span in lines:


Code quality signals

Each signal is named and shown with its evidence. A signal is a fact the scanner read, not a grade.


Declared RFCs

No rfcs.json was found in this project, so it declares no RFCs. This is a finding, not an error: the project has not made an RFC declaration.


Upstream git repo


Public methods and commands

Every public method and command the scanner found, each with a plain English note. A note says where its words came from: the code's own doc comment, the item's signature, the user's agent, or it is marked awaiting a summary.


function — to_tuple

Found in phext_image.py at line 220.

Signature: def to_tuple(self):

What it does: Function to_tuple takes no inputs beyond the value it is called on, and gives back nothing; it does its work on what it is given.

(Where these words came from: signature.)


function — describe

Found in phext_image.py at line 225.

Signature: def describe(self):

What it does: Human-readable semantic description of this pixel.

(Where these words came from: doc comment.)


function — to_rgb

Found in phext_image.py at line 237.

Signature: def to_rgb(self):

What it does: Decode back to approximate RGB via the reverse lookup.

(Where these words came from: doc comment.)


function — semantic_distance

Found in phext_image.py at line 241.

Signature: def semantic_distance(self, other: 'SemanticPixel') -> float:

What it does: Euclidean distance in 7D semantic space.

(Where these words came from: doc comment.)


function — rgb_to_hue_archetype

Found in phext_image.py at line 251.

Signature: def rgb_to_hue_archetype(r, g, b) -> int:

What it does: Map RGB to hue archetype index (0-15).

(Where these words came from: doc comment.)


function — rgb_to_luminance_band

Found in phext_image.py at line 293.

Signature: def rgb_to_luminance_band(r, g, b) -> int:

What it does: Map perceived luminance to band index (0-15).

(Where these words came from: doc comment.)


function — rgb_to_saturation_class

Found in phext_image.py at line 300.

Signature: def rgb_to_saturation_class(r, g, b) -> int:

What it does: Map saturation to class index (0-15).

(Where these words came from: doc comment.)


function — rgb_to_texture_seed

Found in phext_image.py at line 306.

Signature: def rgb_to_texture_seed(r, g, b, neighbors=None) -> int:

What it does: Map local pixel context to texture seed.

(Where these words came from: doc comment.)


function — rgb_to_semantic_domain

Found in phext_image.py at line 334.

Signature: def rgb_to_semantic_domain(r, g, b) -> int:

What it does: Infer semantic domain from color.

(Where these words came from: doc comment.)


function — rgb_to_symbolic_register

Found in phext_image.py at line 381.

Signature: def rgb_to_symbolic_register(r, g, b, semantic_domain=None) -> int:

What it does: Infer symbolic weight from color + domain context.

(Where these words came from: doc comment.)


function — rgb_to_fine_detail

Found in phext_image.py at line 423.

Signature: def rgb_to_fine_detail(r, g, b, x=0, y=0, width=1, height=1) -> int:

What it does: Fine detail classification based on spatial position and value.

(Where these words came from: doc comment.)


function — encode_pixel

Found in phext_image.py at line 451.

Signature: def encode_pixel(r, g, b, x=0, y=0, width=1, height=1, neighbors=None) -> SemanticPixel:

What it does: Encode a single RGB pixel into a 7D semantic coordinate.

(Where these words came from: doc comment.)


function — semantic_to_rgb

Found in phext_image.py at line 492.

Signature: def semantic_to_rgb(sp: SemanticPixel) -> tuple:

What it does: Decode semantic coordinate back to representative RGB.

(Where these words came from: doc comment.)


function — encode_image_to_phext

Found in phext_image.py at line 529.

Signature: def encode_image_to_phext(pixels, width, height) -> str:

What it does: Encode a 2D grid of RGB pixels into a phext document.

(Where these words came from: doc comment.)


function — decode_phext_to_image

Found in phext_image.py at line 607.

Signature: def decode_phext_to_image(phext_doc: str, width: int, height: int) -> list:

What it does: Decode a phext document back into RGB pixel data.

(Where these words came from: doc comment.)


function — analyze_image_semantics

Found in phext_image.py at line 658.

Signature: def analyze_image_semantics(pixels, width, height) -> dict:

What it does: Produce a semantic analysis of an image:

(Where these words came from: doc comment.)


function — demo

Found in phext_image.py at line 735.

Signature: def demo():

What it does: Demonstrate the encoder with some test pixels.

(Where these words came from: doc comment.)


function — parse

Found in resonate.py at line 14.

Signature: def parse(data):

What it does: Function parse takes data and gives back nothing; it does its work on what it is given.

(Where these words came from: signature.)


function — fmt

Found in resonate.py at line 25.

Signature: def fmt(c): return "%d.%d.%d/%d.%d.%d/%d.%d.%d" % c

What it does: Function fmt takes c and gives back nothing; it does its work on what it is given.

(Where these words came from: signature.)


function — toks

Found in resonate.py at line 26.

Signature: def toks(t): return re.findall(r"[a-z0-9']+", t.lower())

What it does: Function toks takes t and gives back nothing; it does its work on what it is given.

(Where these words came from: signature.)


function — build

Found in resonate.py at line 28.

Signature: def build(paths):

What it does: Function build takes paths and gives back nothing; it does its work on what it is given.

(Where these words came from: signature.)


function — resonate

Found in resonate.py at line 38.

Signature: def resonate(text, docs, df, n=8, k1=1.2, b=0.75):

What it does: Function resonate takes text, docs, df, n=8, k1=1.2, b=0.75 and gives back nothing; it does its work on what it is given.

(Where these words came from: signature.)


entry point — main

Found in src/bin/check_toc.rs at line 90.

Signature: fn main() -> ExitCode {

What it does: The entry point: the program starts here. It reads the command line and runs the command the user named.

(Where these words came from: signature.)


entry point — main

Found in src/main.rs at line 1.

Signature: fn main() {

What it does: The entry point: the program starts here. It reads the command line and runs the command the user named.

(Where these words came from: signature.)


struct — PortKey

Found in src/main.rs at line 13.

Signature: pub struct PortKey {

What it does: A data shape named PortKey. Its fields are: pub from: &'static str; pub to: &'static str; pub anchor: (f32, f32, f32); pub glyphs: [&'static str; 5].

(Where these words came from: signature.)


function — PortKey::new

Found in src/main.rs at line 21.

Signature: pub fn new(from: &'static str, to: &'static str) -> Self {

What it does: Function PortKey::new takes from: &'static str, to: &'static str and gives back Self.

(Where these words came from: signature.)


function — transmit

Found in src/main.rs at line 30.

Signature: pub fn transmit(&self) {

What it does: Function transmit takes no inputs beyond the value it is called on, and gives back nothing; it does its work on what it is given.

(Where these words came from: signature.)


Provenance

This documentation is produced for the export repo wbic16/phdoc (its chain of record lives at docs/human/chain.phext) and for the doc site https://docs.phext.io. Both targets are the project's own configuration, held in its .phdoc.json as "export-repo" and "doc-site"; when a project does not name them, the defaults are wbic16/phdoc and https://docs.phext.io.

Historical reference · chain.phext · latest.md