The Problem

Researchers and educators need instant, browser‑based visualizations of cultural datasets without installing heavy tooling. Existing solutions require server‑side processing or complex build steps, making them inaccessible to non‑technical audiences.

What This Does

The repo hosts four interactive HTML tools that run entirely in the browser.

  • ImagePlot 2 (imageplot/index.html) lets users load any image set, extracts 80 visual features, and visualizes the collection in 2‑D/3‑D scatter plots.
  • Photography History (photo/index.html) displays a timeline of key technical milestones in photography.
  • MoMA Artist Networks (moma-networks/index.html) visualizes co‑occurrence networks of artists across MoMA exhibitions.
  • Text Time‑lapse (text-time‑lapse/index.html) shows how a document evolves across saved versions.

Each tool contains its own index.html, supporting screenshots, a README, and a small set of assets. The logic lives in JavaScript files that live next to the HTML, but only the entry points are listed in the tree.

How It Is Wired

Entry point: index.html at the repo root simply links to the four folders. From there, each folder’s index.html loads its own JS bundle (e.g., imageplot/imageplot_2.3.html loads imageplot_2.3.js). The JS files import helper modules (featureExtraction.js, networkBuilder.js, etc.) that perform the heavy lifting. Because the repo does not expose a build system, the wiring is a flat browser load: HTML → JS bundle → DOM manipulation. No server‑side code or database access is present; all data is loaded from local ZIP or JSON files hosted in the same folder. The graph is therefore linear: index.html → load JS → process local files → render. There are no shared services or inter‑module cycles beyond standard ES module imports.

How To Use It

Setup – no build needed; the repo is static. Open the desired index.html file in a browser. If local file access is blocked, run a lightweight server:

# One‑liner using Python 3
python -m http.server 8000

Navigate to http://localhost:8000/imageplot/ (or the other folders).

Configuration – none required. Data files (ZIPs, JSON, TXT) are bundled in each folder; the JS expects those paths verbatim.

Running – simply click the folder link from the root index.html or open the specific index.html file directly.

Real‑World Use

A cultural studies lecturer can embed imageplot/index.html in a classroom presentation to let students experiment with feature spaces of a local art collection. A museum curator can host moma-networks/index.html on an internal site to explore artist co‑occurrence patterns during exhibit planning.

Code Health & Issues

  • Medium – No tests – no test directories or files.
  • Medium – No CI/CD – no .github/ or CI configuration.
  • Low – License missing – only imageplot/LICENSE exists; root lacks a license header.
  • Low – Documentation incomplete – README exists but lacks build or deployment guidance.

No other static analysis findings are present.

The Bottom Line

The repo delivers a set of ready‑to‑use, browser‑based visual essays that require no installation. The lack of tests, CI, and a uniform license reduces confidence for production deployment, but for quick prototyping or educational demos the tools are immediately usable.