@amplib/cosmos

GitHub ↗

generate

Cosmos reports the state of the sky for a given time and place, with every value normalized for driving sound. It is a pure function of its arguments — the same latitude, longitude, and timestamp produce the same result on any machine, in any timezone.

generate({ latitude?: number; longitude?: number; elevation?: number; timestamp?: Date | number; skipPlanets?: boolean; })

generate({
  latitude: ,
  longitude: ,
  timestamp: 
});

Seed

Derived from quantized inputs, so two devices in the same place and hour agree without coordinating. Feed it to @amplib/procedural-generation.

Signals by timescale

The same values regrouped by how fast they move — rotational for rhythm, lunar for phrasing, annual for key, epochal for long-form structure.

Full report