Cival Liquidity Map — Install Guide

Version 1.0.0 · file Cival.LiquidityMap.dll · name in ATAS: Cival Liquidity Map

Cival Liquidity Map is a compiled ATAS plugin. This guide takes you from the downloaded zip to a verified, working indicator. The full list of settings is in 02-Settings-Reference.md.

1. Requirements

Item What you need
Platform ATAS Platform 8.0.15 or newer. The plugin runs on the .NET 10 runtime that ATAS ships; you install nothing else.
Data Ordinary price candles. Cival Liquidity Map uses only open, high, low and close. It does not need footprint data and it does not read the order book.
Instrument A tick size known to ATAS (equal highs and lows are matched within a number of ticks).
History A few hundred bars at least, so that swing highs and lows can be confirmed and zones can live and end. The indicator processes at most the last Maximum bars back bars (default 10,000).
Windows You can write to %APPDATA%\ATAS\Indicators.

2. Install with the included script

  1. Close ATAS completely (check the Windows task manager that no ATAS process is left; a running ATAS locks the DLL).
  2. Extract Cival-Liquidity-Map-v1.0.0.zip to a normal folder and open PowerShell in it.
  3. Run:

powershell .\ATAS\Install.ps1

The script copies Cival.LiquidityMap.dll to %APPDATA%\ATAS\Indicators, keeps a backup of any DLL with the same name that was already there, and verifies the SHA-256 of the copied file against the value recorded in the package. If it reports a mismatch, stop and download the product again. 4. If Windows blocks the script because of the execution policy, run it for this session only:

powershell powershell -ExecutionPolicy Bypass -File .\ATAS\Install.ps1 5. Start ATAS.

3. Manual install

  1. Close ATAS.
  2. Check the file: Get-FileHash .\ATAS\Cival.LiquidityMap.dll -Algorithm SHA256 and compare the value with the Cival.LiquidityMap.dll line in SHA256SUMS.txt.
  3. If %APPDATA%\ATAS\Indicators\Cival.LiquidityMap.dll already exists, copy it somewhere safe first.
  4. Copy ATAS\Cival.LiquidityMap.dll into %APPDATA%\ATAS\Indicators.
  5. Start ATAS. ATAS only loads the new DLL when it starts.

4. First load

  1. Open a candle chart of the market you study, on the timeframe you use. Load some history.
  2. Open the indicator catalog, search for Cival Liquidity Map and add it.
  3. Wait for the historical calculation to finish.
  4. The panel appears at the top-left of the chart, about 50 pixels below the top edge.

What the first panel lines mean

What you see Meaning
Cival Liquidity Map / Waiting for closed candles / historical calculation No closed bar has been delivered yet.
Cival Liquidity Map / Active • N bars • no qualifying setup yet Bars are arriving but the 7 bars needed to confirm a first swing (with the default 3-bar confirmation) have not closed, or nothing has formed yet.
Confirmed pivots: 3-bar delay Line 2 once calculation runs: swing highs and lows are only confirmed 3 bars (the Pivot confirmation bars setting) after they print.
Active zones 10; nearest 12 shown Line 3: how many zones have not been closed through, and how many of them (at most) the chart draws.

You will see only three lines at first. With the default Compact panel (title + two lines) switched on, ATAS shows only the title and the next two lines. The three legend lines (EQH/EQL …, OB/BRK …, SWP …) are hidden. Untick Compact panel (title + two lines) in the Information panel group to see all six.

On the chart. Short horizontal lines for equal highs/lows (EQH, EQL), shaded rectangles for structural blocks and broken blocks, and arrows for sweeps and structure breaks. By default ATAS spells common abbreviations out, so you will read labels such as Liquidity sweep high (price pattern), Structure break displacement and Structure zone structural New (section 4 of 03-Reading-the-Indicator.md lists them all).

5. Settings to touch first

  1. Pivot confirmation bars (default 3), Equal high/low tolerance (ticks) (default 2), Displacement / prior ATR (default 1.5): the three rules that define what is drawn.
  2. Maximum visible zones (default 12): lower it if the chart is crowded (6 to 12 is usually readable).
  3. Show touched levels: off by default; on also draws zones that have been closed through (grey, ending where they ended).
  4. Compact panel (title + two lines): untick to see the legend.

6. Verify it works — checklist

Tick each item.

  1. Get-FileHash of %APPDATA%\ATAS\Indicators\Cival.LiquidityMap.dll matches the SHA256SUMS.txt line.
  2. After restarting ATAS, Cival Liquidity Map appears in the indicator catalog.
  3. Added to a candle chart, the panel title reads Cival Liquidity Map and line 2 reads Confirmed pivots: 3-bar delay.
  4. On a chart with a few hundred bars you can see arrows (sweeps, structure breaks) and at least some horizontal lines or shaded rectangles.
  5. Changing Pivot confirmation bars from 3 to 5 changes line 2 to Confirmed pivots: 5-bar delay and usually reduces the number of pivots, lines and arrows.
  6. Each rectangle's label ends with its state (New or Tested; Invalidated only if Show touched levels is on).
  7. Raising Maximum visible zones draws more zones; lowering it to 3 leaves only the nearest three.
  8. With a CSV export folder set, LiquidityMap-signals.csv and LiquidityMap-zones.csv exist after the calculation finishes.

7. Updating

  1. Close ATAS completely.
  2. Extract the new zip and run its .\ATAS\Install.ps1. The previous same-named DLL is backed up automatically.
  3. Start ATAS and re-add or reload the indicator on your charts.
  4. Before updating, save a chart template and note your three structure settings. If a new version renames or removes a setting, ATAS may fall back to the default for that one setting.
  5. Keep the old zip so that you can return to an older version (close ATAS and copy the older DLL back).

8. Uninstalling

  1. Remove Cival Liquidity Map from your charts and templates.
  2. Close ATAS.
  3. Run .\ATAS\Uninstall.ps1 from the extracted folder, or delete %APPDATA%\ATAS\Indicators\Cival.LiquidityMap.dll yourself.
  4. Exported CSV files stay where you wrote them.

9. Troubleshooting

Symptom Likely cause What to do
Cival Liquidity Map is not in the indicator list ATAS was open during install or not restarted; wrong folder; installer blocked Close ATAS fully, check the DLL is in %APPDATA%\ATAS\Indicators, start ATAS, search for Cival. Use the -ExecutionPolicy Bypass form if the script was blocked.
Panel shows only three lines Compact panel (title + two lines) is on (default) Untick it.
No panel at all Show information panel is off; other Cival panels fill the space (a gold message at the bottom-left says how many panels need space); or the chart is very small Tick Show information panel; hide unused panels.
Nothing is drawn Fewer bars than the confirmation window needs, no confirmed swing yet, every zone already closed through, or Maximum visible zones is too low for the area on screen Check the loaded history, symbol and timeframe first. Scroll to a busier part of the history, tick Show touched levels to see ended zones, raise Maximum visible zones. An empty chart is not a measured zero; it means nothing qualified under the rules. Do not loosen Pivot confirmation bars, tolerance or displacement merely to force objects to appear.
Too many arrows and rectangles The rules are frequent on lower timeframes (the demo sample has 110 sweeps and 51 structure breaks in 4.8 days of 5-minute bars) Raise Pivot confirmation bars or Displacement / prior ATR, lower Maximum visible zones, or turn Show labels off.
Labels are missing Show labels is off; the chart is zoomed out beyond Minimum bar spacing for signal labels (pixels) (default 6); or a label would overlap another (labels are hidden, never moved) Zoom in, tick Show labels, or untick Avoid overlapping labels.
Zones vanish after a time A bar closed through them; ended zones are not drawn unless Show touched levels is on This is the intended lifecycle. See the reading guide.
DLL is locked during install or update An ATAS process is still running Close ATAS, end leftover processes, run the installer again.
Settings reset after an update A setting was renamed or changed in the new version Re-enter your settings from your notes; load your saved template.
CSV files do not appear Folder blank or not writable; calculation not finished Set a writable folder; check for a CSV export failed: line in the panel.
Chart looks different after changing timeframe or history Swings, blocks and zones are rebuilt from the bars loaded Expected. Compare like with like.
A sweep arrow appears but I cannot see the swing it refers to The remembered swing highs and lows are not drawn; only equal pairs (EQH/EQL) become lines Audit it by eye: look back for the latest bar, at least Pivot confirmation bars bars before the arrow, whose high (for a sweep of a high) is strictly above the bars on both sides, and check that the arrow bar traded beyond it and closed back. Section 9 of 03-Reading-the-Indicator.md walks through it.
The same rectangle changed colour A structural block was closed through; its range is redrawn as a broken block (BRK) with the opposite side. The original block ended on that close. Read the label: OB structural is the original, BRK structural the broken-block counterpart.
Equal-high and equal-low lines are rare Equal tolerance is measured in ticks, and a 2-tick tolerance is a tight definition of "equal" on a market with a small tick relative to price Leave it, or choose a wider tolerance on purpose. It changes what "equal" means, so do not change it merely to make more lines appear.
The settings do not match this guide A saved chart or template carries its own values and overrides the defaults Open the indicator settings and compare each value with 02-Settings-Reference.md; reset any you do not recognise.

Still stuck? Email support@civalsystems.com with the product version (1.0.0), your ATAS version, a screenshot with the panel expanded and what you expected to see.