Cival Manipulation & Pressure Toolkit v1.0.0 - Install Guide

Two indicators for ATAS Platform, installed together:

Indicator (display name in ATAS) File Category
Cival Manipulation Cival.Manipulation.dll Cival
Cival Pressure Toolkit Cival.PressureToolkit.dll Cival

Support: support@civalsystems.com.

1. Requirements

Need Cival Manipulation Cival Pressure Toolkit
Platform ATAS Platform 8.0.15 or newer, Windows. Both DLLs target the .NET 10 runtime that ATAS ships; you install nothing extra. Same
Candle data Required Required
Footprint / cluster data (bid and ask volume at each price) Optional but recommended. Used for the recorded-flow evidence. Required only if you set Orderflow confirmation to RequireCompleteDelta. Required for pressure bubbles and wick absorption candidates. Without it the panel says Missing bid/ask footprint: check feed and history.
Individual trade history (ticks) Not used Needed for big prints. ATAS provides up to 7 days; live prints are collected as they arrive. Without it, prints stay off and the panel says so.
Market depth (live) Not used Needed for the live resting depth bars, only during a live session. It is never reconstructed for history.
History About 15 completed bars to warm up; by default the newest 3,000 bars are analysed 21 completed bars with footprint for the first pressure reading; by default the newest 10,000 bars
Chart Start on a regular time-based chart. The worked examples use 5-minute bars. Same

Both indicators need the instrument's real tick size from ATAS.

Step 1. Close ATAS completely (every ATAS window; check Task Manager for leftover ATAS processes).

Step 2. Extract the ZIP to an ordinary folder, for example Downloads\Cival-Manipulation-Pressure-Toolkit-v1.0.0.

Step 3 (optional). Integrity check, in PowerShell from the extracted folder. This compares every file with SHA256SUMS.txt:

Get-Content .\SHA256SUMS.txt | ForEach-Object {
  $hash, $path = $_ -split '  ', 2
  $actual = (Get-FileHash -LiteralPath ($path -replace '/', '\') -Algorithm SHA256).Hash
  '{0}  {1}' -f $(if ($actual -eq $hash) { 'OK      ' } else { 'MISMATCH' }), $path
}

Every line should start with OK (letter case of the hashes does not matter).

Step 4. Run the installer from the extracted folder:

.\ATAS\Install.ps1

It installs both DLLs into %APPDATA%\ATAS\Indicators, backs up any DLL of the same name already there, and verifies the SHA-256 of each copy. If Windows blocks the script because it came from the internet, run Unblock-File .\ATAS\Install.ps1 once (or powershell -ExecutionPolicy Bypass -File .\ATAS\Install.ps1) and try again.

Step 5. Start ATAS.

3. Manual install

  1. Close ATAS.
  2. Copy ATAS\Cival.Manipulation.dll and ATAS\Cival.PressureToolkit.dll into %APPDATA%\ATAS\Indicators (paste that path into Explorer's address bar). You may install just one of them.
  3. If a file with the same name is already there, move it out of the Indicators folder first (keep backups elsewhere; do not leave two copies in the folder).
  4. If Windows marked the files as downloaded, right-click each, choose Properties and tick Unblock, or run Unblock-File on them.
  5. Start ATAS.

4. First load

Open a chart, open its Indicators window (right-click the chart, then Indicators) and search the exact names below. Leave every setting at its default for the first session.

4A. Cival Manipulation

  1. Add Cival Manipulation. A panel titled CIVAL MANIPULATION appears in the top-right of the price pane (it needs a pane of at least 200 x 100 pixels).
  2. Allow about 15 completed bars to warm up (14 prior true ranges for the ATR baseline, then a 12-bar window).
  3. What the panel text means at first:
Panel text Meaning
WARMUP / SCANNING and Waiting for a qualifying closed-bar range Nothing qualifying yet. Normal: the indicator only reports a range after the 12-bar window is compressed (see 03-Reading-the-Indicator).
Waiting for instrument tick size ATAS has not supplied a tick size.
Study unavailable: <error> An unexpected error; the study is cleared until the next recalculation.
Invalid manipulation settings A combination was rejected; nothing is calculated until fixed (for example Range timeout (bars) must not be below Range bars, and Maximum sweep / ATR must not be below Minimum sweep / ATR).
A phase name (RANGE, SWEPT, RECLAIMED, EXPANSION, COMPLETE, INVALIDATED, EXPIRED) with Evidence N/100 · M observable A cycle exists and is selected. Recorded flow F/C bars tells you how many closed bars had usable bid/ask data.

4B. Cival Pressure Toolkit

  1. Add Cival Pressure Toolkit. An information panel titled Cival Pressure Toolkit appears at the top-left of the price pane, with a readiness line and a tape status line.
  2. Switch the chart temporarily to a cluster/footprint view if you want to confirm bid x ask numbers exist in each candle, then switch back.
  3. What the panel text means at first:
Panel text Meaning
Waiting for closed candles / historical calculation History is still loading.
Missing bid/ask footprint: check feed and history / Footprint bid/ask history unavailable The newest closed bar has no footprint rows. Pressure bubbles and absorption candidates cannot be produced.
Partial bid/ask footprint; some tools suppress signals Bid + ask volume does not add up to the candle volume within 1%. This indicator still evaluates the rows it receives, so treat that bar with caution.
Active • N bars • no qualifying setup yet / Active • N signals • M untouched levels Running normally; the second form counts retained markers and the absorption lines that price has not touched.
Waiting for individual prints The tape layer has not received prints yet.
Loading individual historical prints (up to 7 days) A history request is in flight.
No individual print history; live prints only The feed returned no historical trades; big prints will build up from live trades.
Print history unavailable: <message> The history request failed; live prints are still collected.
Tape warmup/coverage X% (required 80%) Too few of the previous 100 bars have prints yet.
Tape X% coverage | N prior prints | threshold T Tape is ready; T is the current big-print size threshold in feed units.
  1. Set the volume floor for your instrument. Minimum aggressive row volume is in the feed's units and defaults to 10. That is a very different size on a coin-denominated perpetual than on an index future. Adjust it before judging the output.

5. Verify it works

Tick every line:

6. Updating

  1. Save your chart template first (indicator settings live in your ATAS workspace and chart templates, not in the DLLs).
  2. Close ATAS and run the new version's .\ATAS\Install.ps1. It backs up the DLLs it replaces.
  3. Start ATAS and reopen your chart. If ATAS was left running, it may offer Reload indicators in the main window's status bar; reopening ATAS is the safe alternative.

7. Uninstalling

Close ATAS, then run .\ATAS\Uninstall.ps1 from the extracted folder (it removes both DLLs), or delete Cival.Manipulation.dll and/or Cival.PressureToolkit.dll from %APPDATA%\ATAS\Indicators by hand. Charts that used the indicators will no longer show them. Exports stay in %APPDATA%\ATAS\CivalManipulation and in any CSV folder you chose until you delete them.

8. Troubleshooting

Symptom Likely cause and fix
Neither indicator is in the list ATAS was not restarted after copying; the DLLs are not directly in %APPDATA%\ATAS\Indicators; Windows blocked the files (Properties, Unblock); ATAS is older than 8.0.15; or you searched a partial name. Search Cival Manipulation and Cival Pressure Toolkit exactly.
Pressure Toolkit: Missing bid/ask footprint: check feed and history (or "waiting for footprint") Your data connection supplies candles without bid/ask volume per price, or the footprint for the newest bars is not loaded. Load tick/cluster history or use a connection that provides it.
Manipulation panel stays at WARMUP / SCANNING Normal until a 12-bar compressed range exists. Check at least 15 completed bars are loaded; if the chart has gaps in time, the study restarts its warm-up after each one.
Manipulation draws nothing and the panel reads Invalid manipulation settings Fix the combination: Range timeout (bars) must be at least Range bars; Maximum sweep / ATR at least Minimum sweep / ATR.
Manipulation shows ranges but cycles end without an expansion Normal. Each phase has a deadline (sweep within 40 bars of the range, reclaim within 3 bars of the sweep, expansion within 8 bars of the reclaim) and a depth limit (1.75 ATR). 03-Reading-the-Indicator lists every ending reason; do not loosen settings only to force a pattern.
Pressure bubble number looks too small The number is the aggressive-side volume summed over the qualifying rows only, not the candle's volume. See section 13 of the Pressure Toolkit part of 03-Reading-the-Indicator.
No Pressure Toolkit bubbles The row floor is too high for the instrument (default 10 feed units), the 3 to 1 Pressure ratio is not met on any row, fewer than 21 footprint bars are loaded, or Pressure bubbles is off.
No big prints Tape status shows why: no print history from your provider, tape coverage below 80% of the previous 100 bars (lowering Minimum populated lookback coverage (%) accepts thinner statistics; Allow incomplete history only overrides a "partial history" flag), or fewer than 30 prior prints. Big prints can only appear on roughly the newest 20 closed bars right after a fresh load.
Depth stale/awaiting fresh feed Depth is live only. Your feed must supply market depth and the chart must be live. Rows older than Depth row expiry (seconds) are dropped; no update within Depth stale timeout (seconds) hides the bars.
Message N panels need space: hide unused panels Several Cival panels share the chart. Turn off Show readiness/status panel on some, or switch Automatic panel placement off and enlarge the pane.
Copy fails: file in use / DLL locked ATAS is still running. Close every ATAS window and process, then run Install.ps1 again.
Settings reset after an update ATAS stores settings by name in the chart template. Restore your saved template or re-enter the settings; keep a template copy before each update.
No alerts Both indicators keep alerts off until you enable them (Local alert on NEW confirmed expansion; Alerts on closed signal / level touch). They stay silent during history loading and recalculation.