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.
2. Install with the included script (recommended)
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
- Close ATAS.
- Copy
ATAS\Cival.Manipulation.dllandATAS\Cival.PressureToolkit.dllinto%APPDATA%\ATAS\Indicators(paste that path into Explorer's address bar). You may install just one of them. - 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).
- If Windows marked the files as downloaded, right-click each, choose Properties and tick Unblock, or run
Unblock-Fileon them. - 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
- 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).
- Allow about 15 completed bars to warm up (14 prior true ranges for the ATR baseline, then a 12-bar window).
- 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
- 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.
- 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.
- 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. |
- 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:
- [ ] Cival Manipulation and Cival Pressure Toolkit both appear in the indicator list and add without an error.
- [ ] The CIVAL MANIPULATION panel is visible, and its text is not
Waiting for instrument tick size. - [ ] After about 15 completed bars, scrolling back through history shows at least one blue range box in an instrument that has compressed ranges (not every chart will in a short window; this is normal).
- [ ] The Pressure Toolkit panel's readiness line begins
Active, notMissing bid/ask footprint. - [ ] After 21 completed bars with footprint, bubbles with a number in the centre and labels beginning
Strong pressureorPressureappear (they need rows of at least the Minimum aggressive row volume with a 3 to 1 ratio, so quiet instruments may show none until you lower the floor). - [ ] The tape status line shows a real status (
Individual print history loaded; live tape active, aTape ... coverageline, or an explicitNo individual print history; live prints only).Waiting for individual printsshould change after history loads. - [ ] Faint grey
Round <price>lines appear around the current price (switch Round-number levels off if you do not want them). - [ ] During a live session with a depth feed, the line
LIVE resting depth (updated levels only)replacesDepth stale/awaiting fresh feed.
6. Updating
- Save your chart template first (indicator settings live in your ATAS workspace and chart templates, not in the DLLs).
- Close ATAS and run the new version's
.\ATAS\Install.ps1. It backs up the DLLs it replaces. - 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. |