# Cyclogram

> App for calculating and communicating your machine operations and cycle times. A browser-based cycle-diagram (machine-cycle timeline) editor for machine-design engineers: actuator lanes, ramped movements, bindings with offsets, a wrap view and a critical path. Local-first — projects stay in the user's browser, are never uploaded, and the app works fully offline after the first sign-in.

Cyclogram models ONE repeating machine cycle: each actuator is a horizontal lane, each movement a ramp-up / body / ramp-down trapezoid, and bindings chain movements together so that moving or lengthening one re-times everything downstream. It is not machine-only: the same lanes, bindings and critical path schedule any process with timed, dependent steps — embedded-system start-up sequences, chemical batch procedures, beer production — with a resolution grid adjustable from 0.1 s to 1 hour. Cycle time is derived (the end of the last movement); the target cycle time is what the engineer types. The free edition has every editing feature, capped at 2 actuators / 6 tasks, with a watermarked PDF export (Excel export is Full-only); a Full licence — an offline .mclic file checked by signature, no subscription, no activation server — removes the cap and watermark and enables Excel export. Enterprise (multi-station, collaboration) is in development. File formats: .mcyc (project, plain JSON), .mclib (library entry), .mclic (signed licence). Cyclogram is not CAD, does no physics or collision simulation, has no public API and stores no projects server-side. Contact: support@cyclogram.app.

## Docs

- [Guide for AI assistants](https://cyclogram.app/ai): The app's exact vocabulary (actuator, task, binding, hooks, marks, wrap, critical path…), editions and licensing, file formats, and the facts an assistant must not get wrong.
- [Security & privacy](https://cyclogram.app/security): What data exists and where — only an e-mail address and a password hash ever reach the server; no cookies, no tracking of individuals (page views are counted by Cloudflare's cookie-free Web Analytics); licences are verified offline.

## Pages

- [Home](https://cyclogram.app/): Landing page with the feature overview, edition comparison table and FAQ.
- [The app](https://cyclogram.app/app/): The editor itself — free sign-in with an e-mail, an interactive guided tour, and the complete 17-section documentation behind the 📖 Docs button.

## Calculations (free, no sign-in)

Every calculator shows its formulas ("Show the math"), is checked number for number against the open opencalc Python packages (calcpkg/1), and turns its result into a Cyclogram task: on a cyclogram bar the ramp-up is the stroke OUT (the whole calculated move), the body is the STAY at the end position, the ramp-down is the stroke BACK. The task is copied and pasted onto the timeline with Ctrl+V, opened by link, or saved as a .mclibrary.

- [All calculations](https://cyclogram.app/calculations/): The index of the calculators below.
- [Move time](https://cyclogram.app/calculations/move-time/): Trapezoidal or triangular move time from distance, top speed and acceleration — or the speed and acceleration a given time needs.
- [Ball screw motor sizing](https://cyclogram.app/calculations/ball-screw-motor-sizing/): Motor speed, reflected inertia, inertia ratio and torque per phase from lead, mass, friction, incline and preload, then a servo / stepper / DC motor check.
- [Belt drive motor sizing](https://cyclogram.app/calculations/belt-drive-motor-sizing/): The same for a belt axis: pulley diameter, carriage and belt mass, pulley inertia, gear ratio.
- [Chain drive motor sizing](https://cyclogram.app/calculations/chain-drive-motor-sizing/): The same for a chain drive or chain conveyor on the sprocket's pitch diameter.
- [Rack and pinion motor sizing](https://cyclogram.app/calculations/rack-and-pinion-motor-sizing/): Pinion pitch diameter, moved mass, friction, incline and gearbox ratio.
- [Roll feeder servo sizing](https://cyclogram.app/calculations/roll-feeder-motor-sizing/): Roll diameter, strip mass, back tension, press friction and roll inertia per feed.
- [Rotary indexing table motor sizing](https://cyclogram.app/calculations/rotary-table-motor-sizing/): Table and workpiece inertia, motor speed and torque per index through the reducer.
- [Linear motor sizing](https://cyclogram.app/calculations/linear-motor-sizing/): Force per phase, peak and RMS force against the motor's continuous force, peak force and top speed.
- [Motor check](https://cyclogram.app/calculations/motor-check/): Can this servo, stepper or DC motor make this move — peak and RMS torque, speed, inertia ratio, pull-out curve, with charts.
- [Slider-crank torque](https://cyclogram.app/calculations/crank-torque/): Slider kinematics and motor torque over one revolution from crank radius, rod length, speed, slider mass and resisting force.
- [Pneumatic cylinder stroke time](https://cyclogram.app/calculations/pneumatic-cylinder-stroke-time/): Time per stroke from bore, stroke, pressure, moved mass and the air the system delivers, with the load ratio.