CPP logic

passed by value (it's a large struct)

.gitignore

@@ -35,3 +35,4 @@ trace_data/
 .ionide/*
 /.ignore
 /build
+.clangd/

.vscode/launch.json

@@ -1,6 +1,30 @@
 {
     "version": "0.2.0",
     "configurations": [
+        {
+            "name": "Spark Local",
+            "type": "cppdbg",
+            "request": "launch",
+            "program": "${workspaceRoot}/build/ninja_debug/server/sparkd",
+            "args": [
+                "run",
+                // "test",
+                // "-a",
+                // "[ilink3]"
+            ],
+            "stopAtEntry": false,
+            "cwd": "${workspaceRoot}/build/ninja_debug/server/",
+            "environment": [],
+            "externalConsole": false,
+            "MIMode": "gdb",
+            "setupCommands": [
+                {
+                    "description": "Enable pretty-printing for gdb",
+                    "text": "-enable-pretty-printing",
+                    "ignoreFailures": true
+                }
+            ]
+        },
         {
             "name": "SparkVM Launch",
             "type": "cppdbg",

CMakeLists.txt

@@ -55,7 +55,7 @@ else ()
     COMMAND ln ARGS -sf ${CMAKE_BINARY_DIR}/web ${CMAKE_BINARY_DIR}/server
     COMMAND ln ARGS -sf ${CMAKE_BINARY_DIR}/data_files ${CMAKE_BINARY_DIR}/server
     COMMAND ln ARGS -sf ${CMAKE_BINARY_DIR}/src/lib/libspark.so ${CMAKE_BINARY_DIR}/server
-    COMMAND ln ARGS -sf ${EXTERNALS_ROOT}/lib/Release/libOnixS.IceImpactMulticastPriceFeedHandlerCpp.so.3.13.0.0 ${CMAKE_BINARY_DIR}/server
+    COMMAND ln ARGS -sf ${EXTERNALS_ROOT}/lib/Release/libOnixS.IceImpactMulticastPriceFeedHandlerCpp.so.3.16.0.0 ${CMAKE_BINARY_DIR}/server
     COMMAND ln ARGS -sf ${EXTERNALS_ROOT}/lib/Release/libACE-5.7.5.so ${CMAKE_BINARY_DIR}/server
     COMMAND mkdir ARGS -p ${CMAKE_BINARY_DIR}/server/plugins
     COMMENT "Creating server runtime layout"

doc/api/content/client/getting-started/services.md

@@ -124,4 +124,17 @@ service OrderService {
 ```
 ### C++ Example
 ```cpp
+#include "lib/api/public/ServiceContext.h"
+#include "lib/api/services/OrderService.client.pb.h"
+using namespace bts::api;
+ServiceContext ctx;
+auto orders = ctx.locate<orderman::OrderService>();
+auto unsub = orders.subscribe_fills().subscribe([](const auto& update) {
+  std::cout 
+    << "Added " << update.added().size() << " items, "
+    << "Removed " << update.removed().size() << " items, "
+    << "Updated " << update.updated().size() << " items, "
+    << "Total items " << update.all().size() << std::endl;
+});
+std::this_thread::sleep_for(std::chrono::minutes(5));
 ```

doc/api/content/client/services/marketdata.md

@@ -1,3 +1,51 @@
 +++
 title = "Market Data"
-+++
++++
+
+
+Use the MarketDataService to subscribe enumerate all available securities.
+
+```cs
+using System;
+using System.Threading;
+using bts.api;
+using bts.api.core;
+
+namespace sample {
+   class Program {
+      static void Main(string[] args) {
+         using var context = new ServiceContext();
+         var md = context.locate<MarketDataService>();
+         using var sub = md.subscribe_securities().Subscribe(update => {
+            foreach (var security in update.added) {
+               Console.WriteLine($"Added security {security.Id}: {security.Symbol}");
+            }
+         });
+
+         Thread.Sleep(TimeSpan.FromMinutes(5));
+      }
+   }
+}
+```
+
+```cpp
+#include "lib/api/public/ServiceContext.h"
+#include "spark/lib/domain_model/Security.h"
+#include "lib/api/services/MarketDataService.client.pb.h"
+#include <thread>
+
+using namespace bts::api;
+
+int main(int argc, char** argv) {
+   ServiceContext ctx;
+   auto md_service = ctx.locate<bts::api::MarketDataService>();
+   auto sub = md_service.subscribe_securities().subscribe([](const auto& update) {
+      for (const auto& s : update.added()) {
+         std::cout << "Added security: " << s->id() << ": " << s->symbol() << std::endl;
+      }
+   });
+
+   std::this_thread::sleep_for(std::chrono::minutes(5));
+   return 0;
+}
+```

doc/api/content/server/getting-started/download.md

@@ -68,12 +68,21 @@ To update your Spark SDK simply download an unzip a new [spark_sdk.zip](https://
 
 To preserve the old image so you can go back to it later run `docker tag spark_sdk spark_sdk:your_custom_tag` before loading the new SDK image.
 
-<!--
-Then stop, remove and restart spark_sdk.
+### Re-build the Dev Container
+
+If you are using Visual Studio Code you also need to rebuild the dev-container so it picks up the new image.
+
+#### Inside VSCode
+To re-build from inside Visual Studio Code.  Click the 'Remote Explorer' icon on the left hand side. 
+You should see your spark_sdk project listed under the Containers section.  Right click on it and select **rebuild-container**.
+
+#### Command Line
+To re-build from the command line run `docker ps -a` and find the row with the spark_sdk image. 
 ```
-c:\bts> docker stop spark_sdk
-c:\bts> docker rm spark_sdk
-c:\bts> docker run -d -v %cd%:/sdk --name spark_sdk bluetradingsytems/spark_sdk
+CONTAINER ID        IMAGE                          COMMAND                  CREATED              STATUS                      PORTS                                NAMES
+54d96cfa3888        spark_sdk                      "/bin/sh -c 'echo Co…"   About a minute ago   Up About a minute           127.0.0.1:9000-9001->9000-9001/tcp   quizzical_lichterman
+```
+Then run `docker rm 54d96cfa3888` (use your container id instead of 54d96cfa3888)  or `docker rm quizzical_lichterman` (use your container name).
+
 
-``` -->
 

doc/user/content/release_notes/_index.md

@@ -1,9 +1,29 @@
-+++
++++
 title = "Release notes"
 weight = 3
 sort_by = "weight"
 insert_anchor_links = "right"
 +++
+## 2.16.2
+### User Visible Change
+  - Synthetic creation dialog has a "fractional" checkbox next to the tick settings.  Users may uncheck this box to enter integer tick sizes, so the synthetic security's prices will be displayed without decimals, or fractional units.
+## 2.16.1
+### Bug Fixes
+  - OrderBook's algo state parameters (in the panel on the right side) are sorted alphabetically
+## 2.16.0
+### Bug Fixes
+  - Solved an issue that could result in incorrect ladder levels
+  - Solved an issue that could lead to incorrect routing of orders in the event of certain MSGW changes
+### API Changes
+  - Add C# client side API samples for order entry, position monitoring and market data observation
+
+## 2.15.10
+### Bug Fixes
+  - Solved an issue that could cause the user interface to fail when playing some alert sounds
+### API Changes
+  - Added settlement and position information to the API
+  - Added the ability for user algos to report custom state to the user interface
+  - Added the ability for algos to discover all active securities
 ## 2.15.3
 ### Bug Fixes
   - Fixed a bug where some CME currency spreads exhibited incorrect tick values
@@ -708,3 +728,4 @@ insert_anchor_links = "right"
 - Start, Day and Total PnL columns are painted with a red or green background color based on if the pnl value is negative or positive respectively
 - Corrected cash per point values, used in pnl calculations, for a number of products
 - PnL report will now remember any customizations you make to filtering and/or sorting criteria
+

global.json

@@ -0,0 +1,6 @@
+{
+  "sdk": {
+    "version": "2.1.508",
+    "rollForward": "latestMajor"
+  }
+}

src/client/Directory.Build.Props

@@ -22,6 +22,10 @@
     <GenDir>$(BaseOutputPath)\gen\$(MSBuildProjectName)</GenDir>
 </PropertyGroup>
 
+<PropertyGroup Condition="'$(VCTargetsPath)'==''">
+    <VCTargetsPath>C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\Common7\IDE\VC\VCTargets</VCTargetsPath>
+</PropertyGroup>
+
 <Import Project="$(ComputerSpecificConfig)" Condition="Exists($(ComputerSpecificConfig))" />
 
 <ItemGroup>

src/client/spark/App.xaml.cs

@@ -115,7 +115,7 @@ namespace mbts.ui.shell
       {
          try
          {
-            var path = Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData) + "\\BTS\\stunnel\\";
+            string path = Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData) + "\\BTS\\stunnel\\";
             if (File.Exists(path + "config\\stunnel.conf"))
             {
                uint job_error = BTSUINativeMethods.setup_process_job_object();   
@@ -124,6 +124,15 @@ namespace mbts.ui.shell
                   kill_stunnel();
                start_stunnel(path, job_error);
             }
+            path = AppDomain.CurrentDomain.BaseDirectory + "\\..\\stunnel\\";
+            if (File.Exists(path + "config\\stunnel.conf"))
+            {
+               uint job_error = BTSUINativeMethods.setup_process_job_object();
+               //if we can't put this process and stunnel into a job, try to stop stunnel then restart
+               if (job_error != 0)
+                  kill_stunnel();
+               start_stunnel(path, job_error);
+            }
          }
          catch(Exception ex)
          {

src/client/spark/Images/Icons.cs

@@ -27,6 +27,7 @@ namespace mbts.ui {
          CheckMarkGeometryKey = nameof(CheckMarkGeometryKey),
          CopyWFGeometryKey = nameof(CopyWFGeometryKey),
          CopyBoxesGeometryKey = nameof(CopyBoxesGeometryKey),
+         CurrencyExchangeGeometryKey = nameof(CurrencyExchangeGeometryKey),
          DataEditGeometryKey = nameof(DataEditGeometryKey),
          DetachAlgosKey = nameof(DetachAlgosKey),
          DiskGeometryKey = nameof(DiskGeometryKey),
@@ -161,6 +162,7 @@ namespace mbts.ui {
       public static ImageSource Clock { get { return load_resource_and_freeze("Clock"); } }
       public static ImageSource CopyWF => create_icon(CopyWFGeometryKey);
       public static ImageSource CopyBoxes => create_icon(CopyBoxesGeometryKey, null, _copy_boxes_pen);
+      public static ImageSource CurrencyExchange => create_icon(CurrencyExchangeGeometryKey);
       public static ImageSource DataEdit => create_icon(DataEditGeometryKey);
       public static ImageSource Defrag { get { return load_resource_and_freeze("Defrag"); } }
       public static ImageSource DetachAlgos => create_icon_and_rotate(DetachAlgosKey, Brushes.Red);

src/client/spark/Images/Vector/Icons.xaml

@@ -62,6 +62,10 @@
     M14.733902,12.084991L9.751783,17.388992 12.982842,17.436005C13.569886,17.462997 14.5229,17.350998 14.876848,17.005005 14.954852,16.929993 15.031879,16.824005 15.02486,16.593002 14.986895,15.457993 14.838883,13.438004 14.733902,12.084991z M22.507753,11.134453C22.480678,11.134323,22.467085,11.135494,22.469961,11.136993L20.64694,11.145004 16.291904,11.192993C16.388891,12.405991 16.596901,15.100998 16.647928,16.539001 16.668924,17.177994 16.448888,17.742004 16.007904,18.168991 15.210897,18.947998 13.893864,19.065002 13.179865,19.065002L9.2818066,19.005005 9.3258129,25.522003 9.3728109,25.528 9.3278271,25.882996 9.3317944,26.395996 9.3107983,26.397995C9.3167797,26.789993,9.3378369,27.552994,9.3958212,29.065994L9.4068075,29.393005C9.4207855,29.819992 9.5648295,29.994995 9.6707884,30.089005 9.9807898,30.365997 10.539817,30.390991 10.717799,30.369003L10.717799,30.375C10.88284,30.354996 11.280855,30.356003 12.823844,30.365997 13.867863,30.371002 15.206869,30.376999 16.594886,30.376999 20.757965,30.376999 23.270998,30.354996 23.862007,30.311005 24.454971,30.268005 24.661029,29.154999 24.690021,28.729996 24.690021,28.729996 24.677997,27.876999 24.661029,26.582993 24.612016,22.671005 24.51198,14.697998 24.472002,12.802002 24.461013,12.302994 24.316969,11.929993 24.034008,11.662003 23.547475,11.200003 22.697284,11.13536 22.507753,11.134453z M8.8867823,2.8410034L2.5417312,10.296997 6.4037791,10.356995C6.8917614,10.390991 8.3258005,10.341003 8.9567896,9.7299957 9.1738335,9.5189972 9.2667919,9.2659912 9.2558046,8.9089966 9.2067934,7.3889923 9.0258213,4.7480011 8.8867823,2.8410034z M10.424826,1.6239929C10.551842,3.302002 10.816799,6.951004 10.876797,8.8560028 10.903836,9.6750031 10.636804,10.360992 10.083818,10.897995 9.0667769,11.882004 7.3527657,11.987991 6.6627546,11.987991 6.4657918,11.987991 6.3367616,11.979004 6.3177796,11.977005L1.6477377,11.905991C1.6387044,14.278992 1.6236895,20.283997 1.6496909,22.358994 1.651705,22.569992 1.6437093,22.780991 1.6366904,22.992004 1.6117265,23.593994 1.5926833,24.112991 1.8537338,24.386002 2.0716933,24.612991 2.6497034,24.886002 4.1457549,24.886002 6.0127832,24.886002 7.0867711,24.876999 7.6967641,24.867004L7.6457993,17.259995 14.853899,9.5849915 16.681924,9.5650024 16.681924,9.5429993 19.454908,9.5289917 19.406934,2.6210022C19.323925,2.3549957,18.960945,1.6239929,17.387928,1.6239929z M9.1738335,0L17.387928,0C19.94692,0,20.874971,1.5299988,21.022983,2.4329987L21.077976,9.5209961 22.446951,9.5139923C22.43395,9.5130005 24.031017,9.4250031 25.148035,10.481995 25.753999,11.054001 26.071996,11.822998 26.092992,12.766998 26.142006,15.065994 26.281044,26.268997 26.307047,28.412003L26.311014,28.764999C26.279029,29.817993 25.750032,31.802002 23.979013,31.931 23.342958,31.977005 20.887972,32 16.683878,32 13.798893,32 11.107818,31.988998 10.808803,31.987991 10.789821,31.990997 9.5147806,32.112 8.6008288,31.309006 8.0858074,30.854996 7.8107797,30.229004 7.7838017,29.444992L7.7728153,29.126999C7.721789,27.759995 7.6978022,26.970993 7.6898061,26.490005 7.0547882,26.5 5.9867817,26.509003 4.1457549,26.509003 2.4377257,26.509003 1.3387128,26.192001 0.68367504,25.509003 -0.055286743,24.742004 -0.017322397,23.742004 0.012707477,22.938004 0.020702986,22.744003 0.028698692,22.559998 0.026684528,22.378998 -0.00029337304,20.240997 0.016674615,13.856995 0.026684528,11.212997L0.026684528,10.867004 0.14167619,10.610992 8.7147823,0.54100037 8.7088009,0.45899963 8.8018194,0.43800354z
   </sys:String>
 
+  <sys:String x:Key="{x:Static mbts:Icons.CurrencyExchangeGeometryKey}">
+    M0,24L15.324005,24C16.042007,24.785004,16.875,25.460999,17.800003,26L2,26 2,30 23.087997,30 23.087006,27.424988C23.771011,27.423004,24.439011,27.352997,25.085999,27.225983L25.085999,30C25.085999,31.10199,24.189011,32,23.085999,32L2,32C0.89700317,32,0,31.10199,0,30z M22.484015,13.026998L23.475018,13.026998 23.475018,13.856997C24.151018,13.885996,24.605021,14.016996,24.93902,14.167996L24.646021,15.233995C24.38302,15.129995 23.919018,14.912995 23.191017,14.912995 22.535015,14.912995 22.323015,15.176995 22.323015,15.440995 22.323015,15.751994 22.676016,15.950994 23.535017,16.251994 24.73702,16.647994 25.222021,17.166993 25.222021,18.015992 25.222021,18.854991 24.58502,19.571991 23.424017,19.759991L23.424017,20.72199 22.434015,20.72199 22.434015,19.825991C21.757013,19.797991,21.101011,19.627991,20.71701,19.420991L21.019012,18.317992C21.444014,18.533992 22.040014,18.731992 22.697016,18.731992 23.272017,18.731992 23.666018,18.524992 23.666018,18.147992 23.666018,17.788992 23.343018,17.562993 22.596016,17.326993 21.515013,16.987993 20.777012,16.516994 20.777012,15.601995 20.777012,14.771996 21.404013,14.119996 22.484015,13.922997z M0.065009117,12.384011L13.628021,12.384011C13.320021,13.018011,13.075021,13.687011,12.89902,14.384011L2.065011,14.384011 2.065011,18.384011 12.68002,18.384011C12.77602,19.075011,12.93702,19.743011,13.16102,20.384011L0.065009117,20.384011z M23.060013,10.460008C19.480015,10.460008 16.568016,13.368006 16.568016,16.943003 16.568016,20.519001 19.480015,23.426999 23.060013,23.427 26.640011,23.426999 29.55201,20.519001 29.55201,16.943003 29.55201,13.368006 26.640011,10.460008 23.060013,10.460008z M23.060013,8.4600086C27.74201,8.4600086 31.552008,12.266006 31.552008,16.943003 31.552008,21.621 27.74201,25.426998 23.060013,25.426998 18.378014,25.426998 14.568016,21.621 14.568016,16.943003 14.568016,12.266006 18.378014,8.4600086 23.060013,8.4600086z M2.0000181,2L2.0000181,6 23.08602,6 23.08602,2z M2.0000181,0L23.08602,0C24.18902,0,25.08602,0.89699936,25.08602,2L25.08602,6.6599998C24.430019,6.5310001 23.753019,6.4599991 23.060019,6.4599991 21.06402,6.4599991 19.20402,7.0300007 17.614019,8L1.8119812E-05,8 1.8119812E-05,2C1.8066406E-05,0.89699936,0.89701813,0,2.0000181,0z
+  </sys:String>
+
   <sys:String x:Key="{x:Static mbts:Icons.DocumentAddGeometryKey}">
     M10.830011,12.05L13.334007,12.05 13.334007,16.535997 17.819998,16.535997 17.819998,19.03902 13.334007,19.03902 13.334007,23.525016 10.830988,23.525016 10.830988,19.03902 6.3460046,19.03902 6.3449975,16.53499 10.830988,16.535997z M2.2799975,2.4149805L2.2799975,29.580015 22.121998,29.580015 22.121998,8.500008 15.83599,8.500008 15.83599,2.4149805z M0,0L15.83599,0 17.125998,0 22.681996,5.439977 24.407,7.125007 24.407,32.000001 0,32.000001z
   </sys:String>
@@ -276,6 +280,7 @@
       m464.867188 0c-25.988282 0-47.132813 21.144531-47.132813 47.132812v313.75c0 49.324219 11.660156 98.710938 33.71875 142.824219 2.539063 5.082031 7.734375 8.292969 13.414063 8.292969 5.683593 0 10.875-3.210938 13.417968-8.292969 22.054688-44.113281 33.714844-93.503906 33.714844-142.824219v-313.75c0-25.988281-21.144531-47.132812-47.132812-47.132812zm0 30c9.445312 0 17.132812 7.6875 17.132812 17.132812v33.199219h-34.265625v-33.199219c0-9.445312 7.683594-17.132812 17.132813-17.132812zm17.132812 323.46875h-34.265625v-243.136719h34.265625zm-17.132812 105.4375c-8.71875-24.277344-14.1875-49.734375-16.222657-75.4375h32.445313c-2.035156 25.707031-7.507813 51.160156-16.222656 75.4375zm0 0
     </sys:String>
   </x:Array>
+
   <sys:String x:Key="{x:Static mbts:Icons.CheckMarkGeometryKey}">
     F1M9.97498,1.22334L4.6983,9.09834 4.52164,9.09834 0,5.19331 1.27664,3.52165 4.255,6.08833 8.33331,1.52588E-05 9.97498,1.22334z
   </sys:String>

src/client/spark/Modules/Market/MarketShellModule.cs

@@ -17,7 +17,7 @@ namespace bts.shell {
    class MarketShellModule : IShellModule {
       [ImportingConstructor]
       public MarketShellModule(IBus bus, MDConsumer consumer, UserSettingsHub settings_hub, OrdersModel orders_model) {
-         _tsf = new TimeAndSalesWindowFactory(this, bus, consumer, settings_hub);
+         _tsf = new TimeAndSalesWindowFactory(this, bus, consumer, settings_hub, orders_model.security_auxiliary_model);
          _mvf = new MarketViewWindowFactory(this, bus, settings_hub, orders_model);
       }
 

src/client/spark/Modules/Market/MarketView/MarketViewRow.cs

@@ -1,10 +1,12 @@
 using bts.api;
 using bts.api.orderman;
 using bts.collections;
+using bts.utils;
 using mbts.co2;
 using mbts.spark.utilities;
 using mbts.ui;
 using mbts.ui.controls;
+using mbts.ui.shell;
 using mbts.ui.spark;
 using mbts.ui.utility;
 using mbts.utils;
@@ -24,7 +26,6 @@ namespace mbts.spark {
          readonly AnimationManager _animation = new AnimationManager();
          readonly ObservableCollection<OrderRecordImmutable> _orders = new ObservableCollection<OrderRecordImmutable>();
          readonly ObservableFilterCollection<OrderRecordImmutable> _working_orders, _working_bids, _working_asks;
-         readonly string _security_text, _security_key_text;
          readonly Property<double> _bid_price, _ask_price, _last_price, _day_change, _settlement, _session_high, _session_low;
          readonly Property<bool> _last_price_from_spread;
          readonly CellProperty<int> _position;
@@ -33,48 +34,51 @@ namespace mbts.spark {
          readonly CellProperty<bool> _inside_bids, _inside_asks;
          readonly CellProperty<int> _working_bid_volume, _working_ask_volume;
          readonly CellProperty<double> _working_best_bid, _working_best_ask;
-         readonly CellProperty<string> _working_bids_text, _working_asks_text;
          readonly MyOrderSummarizer _order_summarizer = new MyOrderSummarizer();
          readonly MDDisplayHelper.SizeFormatter _size_formatter = MDDisplayHelper.get_formatter(MarketSizeDisplay.get_default());
-         Property<uint> _bid_direct_size, _bid_merged_size, _ask_direct_size, _ask_merged_size;
+         PropertyAutoWrapper<uint, uint>
+            _bid_direct_size,
+            _bid_implied_size,
+            _bid_merged_size,
+            _ask_direct_size,
+            _ask_implied_size,
+            _ask_merged_size;
          double _raw_day_position;
-         string _bid_merged_size_text, _ask_merged_size_text;
          ulong _bbo_ref, _last_ref;
+         uint? _display_qty_divisor_backing;
 
          public Row(IBus bus, SecurityMD smd, OrdersModel orders_model) : base(smd) {
             _bus = bus;
             _orders_model = orders_model;
-            _security_text = smd.security.ToString();
-            _security_key_text = security_key.ToString();
             string format_price(double price) => security.ContractSpec.format(price);
-            _position = new CellProperty<int>(this, nameof(position), 0);
+            _position = new CellProperty<int>(this, nameof(position), fmt_display_qty_int);
             _bid_price = backing(nameof(bid_price), double.NaN);
             _ask_price = backing(nameof(ask_price), double.NaN);
             _last_price = backing(nameof(last_price), double.NaN);
-            _last_size = new CellProperty<uint>(this, nameof(last_size), 0);
+            _last_size = new CellProperty<uint>(this, nameof(last_size), fmt_display_qty_uint);
             _day_change = backing(nameof(day_change), double.NaN);
             _session_low = backing(nameof(session_low), double.NaN);
             _session_high = backing(nameof(session_high), double.NaN);
             _last_price_from_spread = backing(nameof(last_price_from_spread), false);
             _settlement = backing(nameof(settlement), double.NaN);
-            _volume = new CellProperty<ulong>(this, nameof(volume), 0);
+            _volume = new CellProperty<ulong>(this, nameof(volume), fmt_display_qty_ulong, 0);
             _inside_bids = new CellProperty<bool>(this, nameof(inside_bids));
             _inside_asks = new CellProperty<bool>(this, nameof(inside_asks));
             _working_bid_volume = new CellProperty<int>(this, nameof(working_bid_volume));
             _working_ask_volume = new CellProperty<int>(this, nameof(working_ask_volume));
             //
-            _bid_direct_size = backing(nameof(bid_direct_size), default(uint));
-            _bid_merged_size = backing(nameof(bid_merged_size), default(uint));
-            _ask_direct_size = backing(nameof(ask_direct_size), default(uint));
-            _ask_merged_size = backing(nameof(ask_merged_size), default(uint));
+            _bid_direct_size = backing(nameof(bid_direct_size), 0u, convert_display_qty_uint);
+            _bid_implied_size = backing(nameof(bid_implied_size), 0u, convert_display_qty_uint);
+            _bid_merged_size = backing(nameof(bid_merged_size), 0u, convert_display_qty_uint);
+            _ask_direct_size = backing(nameof(ask_direct_size), 0u, convert_display_qty_uint);
+            _ask_implied_size = backing(nameof(ask_implied_size), 0u, convert_display_qty_uint);
+            _ask_merged_size = backing(nameof(ask_merged_size), 0u, convert_display_qty_uint);
             //
             _working_orders = new ObservableFilterCollection<OrderRecordImmutable>(_orders, o => o.is_active());
             _working_bids = new ObservableFilterCollection<OrderRecordImmutable>(_working_orders, o => o.Def.Side == Side.Buy);
             _working_asks = new ObservableFilterCollection<OrderRecordImmutable>(_working_orders, o => o.Def.Side == Side.Sell);
             _working_best_bid = new CellProperty<double>(this, nameof(working_best_bid), format_price, double.NaN);
             _working_best_ask = new CellProperty<double>(this, nameof(working_best_ask), format_price, double.NaN);
-            _working_bids_text = new CellProperty<string>(this, nameof(working_bids_text), string.Empty);
-            _working_asks_text = new CellProperty<string>(this, nameof(working_asks_text), string.Empty);
             //
             default_command = new DelegateCommand(_show_ladder);
             bid_price_click = new DelegateCommand(() => _show_order_ticket(MarketViewView.Columns.Bid));
@@ -90,17 +94,45 @@ namespace mbts.spark {
             _animation.AnimationsChanged += on_animations_changed;
             void on_animations_changed() => RaisePropertyChanged(nameof(animations));
             _dispose = Disposable.Create(
+               attach_prop_changed_cb(_bid_direct_size, mk_echo_prop_changed_cb<(uint,uint)>(nameof(bid_direct_size_text))),
+               attach_prop_changed_cb(_bid_implied_size, mk_echo_prop_changed_cb<(uint,uint)>(nameof(bid_implied_size_text))),
+               attach_prop_changed_cb(_bid_merged_size, mk_echo_prop_changed_cb<(uint,uint)>(nameof(bid_merged_size_text))),
+               attach_prop_changed_cb(_ask_direct_size, mk_echo_prop_changed_cb<(uint,uint)>(nameof(ask_direct_size_text))),
+               attach_prop_changed_cb(_ask_implied_size, mk_echo_prop_changed_cb<(uint,uint)>(nameof(ask_implied_size_text))),
+               attach_prop_changed_cb(_ask_merged_size, mk_echo_prop_changed_cb<(uint,uint)>(nameof(ask_merged_size_text))),
                _orders_model.on_security_root_orders(security.Id).OnDispatcher().Subscribe(_on_orders),
                _position.OnDispatcher().Subscribe(v => _animation.animate_position(v.newval > v.oldval)),
                _orders_model.on_security_positions(security.Id).OnDispatcher().Subscribe(t => {
-                  if (Set(ref _raw_day_position, t.state.Values.Sum(p => p.Item2.raw_day_pos()), nameof(raw_day_position)))
+                  if (Set(ref _raw_day_position, t.state.Values.Sum(p => p.Item2.raw_day_pos()), nameof(raw_day_position))) {
+                     RaisePropertyChanged(nameof(raw_day_position_text));
                      raise_invalidated();
+                  }
                }),
                _inside_bids.OnDispatcher().Subscribe(v => _animation.animate_working_bids_inside(v.newval)),
                _inside_asks.OnDispatcher().Subscribe(v => _animation.animate_working_asks_inside(v.newval)),
                _day_change.OnDispatcher().Subscribe(v => _animation.animate_day_change(v.newval > v.oldval)),
                Disposable.Create(() => _animation.AnimationsChanged -= on_animations_changed)
             );
+
+            uint convert_display_qty_uint(uint value) =>
+               value.safe_divide(_display_qty_divisor);
+
+            string fmt_display_qty_int(int value) =>
+               value.safe_divide(_display_qty_divisor).ToString();
+
+            string fmt_display_qty_uint(uint value) =>
+               value.safe_divide(_display_qty_divisor).ToString();
+
+            string fmt_display_qty_ulong(ulong value) =>
+               value.safe_divide(_display_qty_divisor).ToString();
+
+            PropertyChange<T> mk_echo_prop_changed_cb<T>(params string[] props) =>
+               (oldval, newval) => RaisePropertyChanged(props);
+
+            IDisposable attach_prop_changed_cb<TView, TModel>(PropertyAutoWrapper<TModel, TView> prop, PropertyChange<(TModel, TView)> callback) {
+               prop.changed += callback;
+               return Disposable.Create(() => prop.changed -= callback);
+            }
          }
 
          public event Action invalidated;
@@ -109,32 +141,63 @@ namespace mbts.spark {
          public bool inside_bids => _inside_bids.value;
          public bool inside_asks => _inside_asks.value;
          public int position => _position.value;
+         public string position_text => _position.text;
          public double raw_day_position => _raw_day_position;
+         public string raw_day_position_text => SparkUtils.fmt_position(_raw_day_position.safe_divide(_display_qty_divisor));
          public double last_price => _last_price.Value;
          public bool last_price_from_spread => _last_price_from_spread.Value;
          public uint last_size => _last_size.value;
+         public string last_size_text => _last_size.text;
+         // bid price/size
          public double bid_price => _bid_price.Value;
-         public uint bid_direct_size => _bid_direct_size.Value;
-         public uint bid_implied_size => _bid_merged_size.Value - _bid_direct_size.Value;
-         public uint bid_merged_size => _bid_merged_size.Value;
-         public string bid_merged_size_text => _bid_merged_size_text ?? (_bid_merged_size_text = _size_formatter(_bid_merged_size.Value, bid_implied_size));
+         public uint bid_direct_size => _bid_direct_size.model;
+         public uint bid_implied_size => _bid_merged_size.model - _bid_direct_size.model;
+         public uint bid_merged_size => _bid_merged_size.model;
+         // bid size text
+         public string bid_direct_size_text => _bid_direct_size.view.ToString();
+         public string bid_implied_size_text => _bid_implied_size.view.ToString();
+         public string bid_merged_size_text => _bid_merged_size.view.ToString();
+         // ask price/size
          public double ask_price => _ask_price.Value;
-         public uint ask_direct_size => _ask_direct_size.Value;
-         public uint ask_implied_size => _ask_merged_size.Value - _ask_direct_size.Value;
-         public uint ask_merged_size => _ask_merged_size.Value;
-         public string ask_merged_size_text => _ask_merged_size_text ?? (_ask_merged_size_text = _size_formatter(_ask_merged_size.Value, ask_implied_size));
+         public uint ask_direct_size => _ask_direct_size.model;
+         public uint ask_implied_size => _ask_implied_size.model;
+         public uint ask_merged_size => _ask_merged_size.model;
+         // ask size text
+         public string ask_direct_size_text => _ask_direct_size.view.ToString();
+         public string ask_implied_size_text => _ask_implied_size.view.ToString();
+         public string ask_merged_size_text => _ask_merged_size.view.ToString();
+         //
          public ulong volume => _volume.value;
+         public string volume_text => _volume.text;
          public double settlement => _settlement.Value;
          public double day_change => _day_change.Value;
          public double session_low => _session_low.Value;
          public double session_high => _session_high.Value;
          public int working_bid_volume => _working_bid_volume.value;
          public int working_ask_volume => _working_ask_volume.value;
-         public string working_bids_text => OrderUtils.order_collection_summary(_order_summarizer.best_working_bid, _order_summarizer.best_working_bid_qty, _order_summarizer.working_bid_qty, security.ContractSpec);
-         public string working_asks_text => OrderUtils.order_collection_summary(_order_summarizer.best_working_ask, _order_summarizer.best_working_ask_qty, _order_summarizer.working_ask_qty, security.ContractSpec);
+         public string working_bids_text => OrderUtils.order_collection_summary(
+            _order_summarizer.best_working_bid,
+            _order_summarizer.best_working_bid_qty.safe_divide(_display_qty_divisor),
+            _order_summarizer.working_bid_qty.safe_divide(_display_qty_divisor),
+            security.ContractSpec);
+         public string working_asks_text => OrderUtils.order_collection_summary(
+            _order_summarizer.best_working_ask,
+            _order_summarizer.best_working_ask_qty.safe_divide(_display_qty_divisor),
+            _order_summarizer.working_ask_qty.safe_divide(_display_qty_divisor),
+            security.ContractSpec);
          public double working_best_bid => _working_best_bid.value;
          public double working_best_ask => _working_best_ask.value;
+         // ice props
+         public string market_description => security.market_description();
+         public string cleared_alias => security.cleared_alias();
+         public string product_description => security.product_name();
+         public string hub_alias => security.hub_alias();
+         public string strip_name => security.strip_name();
+         public string mic_code => security.mic_code();
+         // animations
          public IList<ui.spark.CellAnimation> animations => _animation.get_animations().ToList();
+         public ObservableCollection<RowAnimation> row_animations { get; } = new ObservableCollection<RowAnimation>();
+         // commands
          public ICommand bid_price_click { get; }
          public ICommand bid_merged_size_click { get; }
          public ICommand bid_direct_size_click { get; }
@@ -146,27 +209,30 @@ namespace mbts.spark {
          public ICommand ask_implied_size_click { get; }
          public ICommand working_asks_click { get; }
          public ICommand default_command { get; }
-         public string market_description {get;}
-         public string cleared_alias { get; }
-         public string product_description { get; }
-         public string hub_alias { get; }
-         public string strip_name{ get; }
-         public string mic_code { get; }
-
-         public ObservableCollection<RowAnimation> row_animations { get; } = new ObservableCollection<RowAnimation>();
 
          public IReadOnlyList<DIYGrid.IGridCellStore> cell_stores => new DIYGrid.IGridCellStore[0];
          #endregion
 
+         uint _display_qty_divisor => _display_qty_divisor_backing ??
+            (_display_qty_divisor_backing = _orders_model.security_auxiliary_model.get_display_quantity_divisor(security)).Value;
+
          public void raise_invalidated() => invalidated?.Invoke();
 
          public void refresh() {
             bool dirty = false;
             if (md.md.get_bbo(ref _bbo_ref, out NativePriceSize b, out NativePriceSize a)) {
                _bid_price.set(b.price);
-               refresh_size(ref b, _bid_direct_size, _bid_merged_size, ref _bid_merged_size_text, nameof(bid_merged_size_text));
+               // don't use the '||' operator - every 'set_new' call must be made
+               // (the operation mustn't terminate the first time a set_new call returns true).
+               dirty |= (
+                  _bid_direct_size.set_new(b.direct_size) |
+                  _bid_implied_size.set_new(b.implied_size) |
+                  _bid_merged_size.set_new(b.size) |
+                  _ask_direct_size.set_new(a.direct_size) |
+                  _ask_implied_size.set_new(a.implied_size) |
+                  _ask_merged_size.set_new(a.size));
+
                _ask_price.set(a.price);
-               refresh_size(ref a, _ask_direct_size, _ask_merged_size, ref _ask_merged_size_text, nameof(ask_merged_size_text));
                _inside_bids.on_next_distinct(_bid_price.Value >= _working_best_bid.value, ref dirty);
                _inside_asks.on_next_distinct(_ask_price.Value <= _working_best_ask.value, ref dirty);
             }
@@ -183,16 +249,6 @@ namespace mbts.spark {
             _volume.on_next_distinct(md.md.total_volume, ref dirty);
             if (dirty)
                invalidated?.Invoke();
-
-            void refresh_size(ref NativePriceSize nps, Property<uint> direct, Property<uint> merged, ref string text, string text_prop) {
-               if (nps.size != merged.Value || nps.direct_size != direct.Value) {
-                  merged.set(nps.size);
-                  direct.set(nps.direct_size);
-                  text = null;
-                  dirty = true;
-                  RaisePropertyChanged(text_prop);
-               }
-            }
          }
 
          public bool Equals(Row other) =>

src/client/spark/Modules/Market/MarketView/MarketViewVM.cs

@@ -9,6 +9,7 @@ using mbts.ui.utility;
 using System;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
+using System.Linq;
 using System.Reactive.Linq;
 using System.Windows.Data;
 using System.Windows.Media;
@@ -18,6 +19,9 @@ using static mbts.ui.spark.MarketViewView;
 
 namespace mbts.spark {
    partial class MarketViewVM : SecurityMDGrid<MarketViewVM.Row, SecurityMD> {
+      static IReadOnlyList<Func<MarketViewVM, IDataGridColumnFilter<Row>>> _filter_getters =
+         ObjectSnapshot.property_delegates_of_type<MarketViewVM, IDataGridColumnFilter<Row>>();
+
       readonly IBus _bus;
       readonly OrdersModel _orders_model;
       IWindowSettingsManager<GridSettings> _settings_manager;
@@ -37,21 +41,21 @@ namespace mbts.spark {
          const double working_orders_col_width = 105;
          IMultiValueConverter price_converter = new ui.spark.converters.TickDisplayConverter();
          add_col(Columns.Security, "Security", r => r.security.ToString(), nameof(Row.security), DefaultColumnWidths.Security, security_filter, DataGridFilterKnownTemplates.Regex);
-         add_col(Columns.Volume, "Volume", r => r.volume.ToString(), nameof(Row.volume), DefaultColumnWidths.Volume, volume_filter, DataGridFilterKnownTemplates.ULongMinMax);
+         add_col(Columns.Volume, "Volume", r => r.volume_text, nameof(Row.volume), DefaultColumnWidths.Volume, volume_filter, DataGridFilterKnownTemplates.ULongMinMax);
          add_col(Columns.LastSpd, "Spd", r => r.last_price_from_spread ? "S" : "", nameof(Row.last_price_from_spread), DefaultColumnWidths.Side, last_price_from_spread_filter, DataGridFilterKnownTemplates.Regex);
          add_col(Columns.Last, "Last", r => r.format_price(r.last_price), nameof(Row.last_price), DefaultColumnWidths.Price, last_price_filter, DataGridFilterKnownTemplates.DoubleMinMax);         
-         add_col(Columns.LastSize, merged_size_col_header, r => r.last_size.ToString(), nameof(Row.last_size), DefaultColumnWidths.Size, last_size_filter, DataGridFilterKnownTemplates.UIntMinMax, h_alignment: System.Windows.HorizontalAlignment.Right);
-         add_col(Columns.Position, "Pos", r => r.position.ToString(), nameof(Row.position), DefaultColumnWidths.Size, position_filter, DataGridFilterKnownTemplates.IntMinMax, true, h_alignment: System.Windows.HorizontalAlignment.Right);
-         add_col(Columns.RawDayPosition, "Raw Day Pos", r => SparkUtils.fmt_position(r.raw_day_position), nameof(Row.raw_day_position), DefaultColumnWidths.Size, raw_day_position_filter, DataGridFilterKnownTemplates.DoubleMinMax, true, h_alignment: System.Windows.HorizontalAlignment.Right);
+         add_col(Columns.LastSize, merged_size_col_header, r => r.last_size_text, nameof(Row.last_size), DefaultColumnWidths.Size, last_size_filter, DataGridFilterKnownTemplates.UIntMinMax, h_alignment: System.Windows.HorizontalAlignment.Right);
+         add_col(Columns.Position, "Pos", r => r.position_text, nameof(Row.position), DefaultColumnWidths.Size, position_filter, DataGridFilterKnownTemplates.IntMinMax, true, h_alignment: System.Windows.HorizontalAlignment.Right);
+         add_col(Columns.RawDayPosition, "Raw Day Pos", r => r.raw_day_position_text, nameof(Row.raw_day_position), DefaultColumnWidths.Size, raw_day_position_filter, DataGridFilterKnownTemplates.DoubleMinMax, true, h_alignment: System.Windows.HorizontalAlignment.Right);
          add_hl_working_orders_col(Columns.WorkingBids, working_col_header, nameof(Row.working_bids_text), nameof(Row.working_best_bid), nameof(Row.working_bids_click), working_bid_volume_filter, BTSColors.MarketData.bid, System.Windows.HorizontalAlignment.Right);
-         add_col(Columns.BidImpliedSize, implied_size_col_header, r => r.bid_implied_size.ToString(), nameof(Row.bid_implied_size), DefaultColumnWidths.ImpliedDirectMergedSize, bid_implied_size_filter, DataGridFilterKnownTemplates.UIntMinMax, font_color: BTSColors.MarketData.bid, h_alignment: System.Windows.HorizontalAlignment.Right);
-         add_col(Columns.BidDirectSize, direct_size_col_header, r => r.bid_direct_size.ToString(), nameof(Row.bid_direct_size), DefaultColumnWidths.ImpliedDirectMergedSize, bid_direct_size_filter, DataGridFilterKnownTemplates.UIntMinMax, font_color: BTSColors.MarketData.bid, h_alignment: System.Windows.HorizontalAlignment.Right);
+         add_col(Columns.BidImpliedSize, implied_size_col_header, r => r.bid_implied_size_text, nameof(Row.bid_implied_size), DefaultColumnWidths.ImpliedDirectMergedSize, bid_implied_size_filter, DataGridFilterKnownTemplates.UIntMinMax, font_color: BTSColors.MarketData.bid, h_alignment: System.Windows.HorizontalAlignment.Right);
+         add_col(Columns.BidDirectSize, direct_size_col_header, r => r.bid_direct_size_text, nameof(Row.bid_direct_size), DefaultColumnWidths.ImpliedDirectMergedSize, bid_direct_size_filter, DataGridFilterKnownTemplates.UIntMinMax, font_color: BTSColors.MarketData.bid, h_alignment: System.Windows.HorizontalAlignment.Right);
          add_hl_merged_size_col(Columns.BidMergedSize, merged_size_col_header, nameof(Row.bid_merged_size), nameof(Row.bid_merged_size_text), nameof(Row.bid_merged_size_click), bid_merged_size_filter, BTSColors.MarketData.bid, h_alignment: System.Windows.HorizontalAlignment.Right);
          add_hl_price_col(Columns.Bid, "Bid", nameof(Row.bid_price), nameof(Row.bid_price_click), bid_price_filter, BTSColors.header_text, BTSColors.MarketData.bid, h_alignment: System.Windows.HorizontalAlignment.Right);
          add_hl_price_col(Columns.Ask, "Ask", nameof(Row.ask_price), nameof(Row.ask_price_click), ask_price_filter, BTSColors.header_text, BTSColors.MarketData.ask, h_alignment: System.Windows.HorizontalAlignment.Right);
          add_hl_merged_size_col(Columns.AskMergedSize, merged_size_col_header, nameof(Row.ask_merged_size), nameof(Row.ask_merged_size_text), nameof(Row.ask_merged_size_click), ask_merged_size_filter, BTSColors.MarketData.ask, h_alignment: System.Windows.HorizontalAlignment.Right);
-         add_col(Columns.AskDirectSize, direct_size_col_header, r => r.ask_direct_size.ToString(), nameof(Row.ask_direct_size), DefaultColumnWidths.ImpliedDirectMergedSize, ask_direct_size_filter, DataGridFilterKnownTemplates.UIntMinMax, font_color: BTSColors.MarketData.ask, h_alignment: System.Windows.HorizontalAlignment.Right);
-         add_col(Columns.AskImpliedSize, implied_size_col_header, r => r.ask_implied_size.ToString(), nameof(Row.ask_implied_size), DefaultColumnWidths.ImpliedDirectMergedSize, ask_implied_size_filter, DataGridFilterKnownTemplates.UIntMinMax, font_color: BTSColors.MarketData.ask, h_alignment: System.Windows.HorizontalAlignment.Right);
+         add_col(Columns.AskDirectSize, direct_size_col_header, r => r.ask_direct_size_text, nameof(Row.ask_direct_size), DefaultColumnWidths.ImpliedDirectMergedSize, ask_direct_size_filter, DataGridFilterKnownTemplates.UIntMinMax, font_color: BTSColors.MarketData.ask, h_alignment: System.Windows.HorizontalAlignment.Right);
+         add_col(Columns.AskImpliedSize, implied_size_col_header, r => r.ask_implied_size_text, nameof(Row.ask_implied_size), DefaultColumnWidths.ImpliedDirectMergedSize, ask_implied_size_filter, DataGridFilterKnownTemplates.UIntMinMax, font_color: BTSColors.MarketData.ask, h_alignment: System.Windows.HorizontalAlignment.Right);
          add_hl_working_orders_col(Columns.WorkingAsks, working_col_header, nameof(Row.working_asks_text), nameof(Row.working_best_ask), nameof(Row.working_asks_click), working_ask_volume_filter, BTSColors.MarketData.ask, System.Windows.HorizontalAlignment.Right);
          add_col(Columns.Settlement, "Settlement", r => r.format_price(r.settlement), nameof(Row.settlement), DefaultColumnWidths.Settlement, settlement_filter, DataGridFilterKnownTemplates.DoubleMinMax, h_alignment: System.Windows.HorizontalAlignment.Right);
          add_col(Columns.DayChange, "Change", r => r.format_price(r.day_change), nameof(Row.day_change), DefaultColumnWidths.Price, day_change_filter, DataGridFilterKnownTemplates.DoubleMinMax, true, h_alignment: System.Windows.HorizontalAlignment.Right);
@@ -151,14 +155,16 @@ namespace mbts.spark {
                      working_ask_volume_filter.load_state(filters.working_ask_volume);
                      volume_filter.load_state(filters.volume);
                      security_key_filter.load_state(filters.security_key);
+                     market_description_filter.load_state(filters.market_description);
+                     cleared_alias_filter.load_state(filters.cleared_alias);
+                     product_description_filter.load_state(filters.product_description);
+                     hub_alias_filter.load_state(filters.hub_alias);
+                     strip_name_filter.load_state(filters.strip_name);
+                     mic_code_filter.load_state(filters.mic_code);
                   }
                   rows_view.set_sort_descriptions(s.sorting_criterion, columns);
                }
-            }), DataGridFilterHelper.hook_filters(rows_view, security_filter,
-            bid_price_filter, bid_merged_size_filter, bid_direct_size_filter, bid_implied_size_filter,
-            ask_price_filter, ask_merged_size_filter, ask_direct_size_filter, ask_implied_size_filter,
-            last_price_filter, last_price_from_spread_filter, last_size_filter, day_change_filter, settlement_filter,
-            session_low_filter, session_high_filter, position_filter, raw_day_position_filter, working_bid_volume_filter, working_ask_volume_filter, volume_filter, security_key_filter),
+            }), DataGridFilterHelper.hook_filters(rows_view, _filters),
             settings_manager.subscribe_current().OnDispatcher().Subscribe(grid_settings_manager),
             WorkLoop.Start("MarketView", _refresh)
          );
@@ -233,13 +239,15 @@ namespace mbts.spark {
       public IDataGridColumnPersistentFilter<Row, ULongMinMaxState> volume_filter { get; } = new ULongMinMax<Row>(r => r.volume, nameof(Row.volume));
       public IDataGridColumnPersistentFilter<Row, string> security_key_filter { get; } = new RegexFilterVM<Row>(r => r.security_key.ToString(), nameof(Row.security_key));
       
-      public IDataGridColumnPersistentFilter<Row, string> market_description_filter { get; } = new RegexFilterVM<Row>(r => r.security.HasIce ? r.security.Ice.MarketDescription : "", nameof(Row.market_description));
-      public IDataGridColumnPersistentFilter<Row, string> cleared_alias_filter { get; } = new RegexFilterVM<Row>(r => r.security.HasIce ? r.security.Ice.ClearedAlias : "", nameof(Row.cleared_alias));
-      public IDataGridColumnPersistentFilter<Row, string> product_description_filter { get; } = new RegexFilterVM<Row>(r => r.security.HasIce ? r.security.Ice.ProductName : "", nameof(Row.product_description));
-      public IDataGridColumnPersistentFilter<Row, string> hub_alias_filter { get; } = new RegexFilterVM<Row>(r => r.security.HasIce ? r.security.Ice.HubAlias : "", nameof(Row.hub_alias));
-      public IDataGridColumnPersistentFilter<Row, string> strip_name_filter { get; } = new RegexFilterVM<Row>(r => r.security.HasIce ? r.security.Ice.StripName : "", nameof(Row.strip_name));
-      public IDataGridColumnPersistentFilter<Row, string> mic_code_filter { get; } = new RegexFilterVM<Row>(r => r.security.HasIce ? r.security.Ice.MicCode : "", nameof(Row.mic_code));
-      
+      public IDataGridColumnPersistentFilter<Row, string> market_description_filter { get; } = new RegexFilterVM<Row>(r => r.market_description, nameof(Row.market_description));
+      public IDataGridColumnPersistentFilter<Row, string> cleared_alias_filter { get; } = new RegexFilterVM<Row>(r => r.cleared_alias, nameof(Row.cleared_alias));
+      public IDataGridColumnPersistentFilter<Row, string> product_description_filter { get; } = new RegexFilterVM<Row>(r => r.product_description, nameof(Row.product_description));
+      public IDataGridColumnPersistentFilter<Row, string> hub_alias_filter { get; } = new RegexFilterVM<Row>(r => r.hub_alias, nameof(Row.hub_alias));
+      public IDataGridColumnPersistentFilter<Row, string> strip_name_filter { get; } = new RegexFilterVM<Row>(r => r.strip_name, nameof(Row.strip_name));
+      public IDataGridColumnPersistentFilter<Row, string> mic_code_filter { get; } = new RegexFilterVM<Row>(r => r.mic_code, nameof(Row.mic_code));
+
+      IEnumerable<IDataGridColumnFilter<Row>> _filters =>
+         _filter_getters.Select(fn => fn(this));
 
       public FilterStates get_filter_states() {
          return new FilterStates {

src/client/spark/Modules/Market/TimeAndSales/TimeAndSalesRowVM.cs

@@ -22,12 +22,15 @@ namespace bts.shell.time_and_sales {
          .to_safe();
 
       readonly TradeMessageImmutable _trade;
+      readonly Func<SecurityImmutable?, uint> _get_display_qty_divisor;
+      uint? _display_size;
 
-      public TimeAndSalesRowVM(int row_key, SecurityImmutable security, TradeMessageImmutable trade) {
+      public TimeAndSalesRowVM(int row_key, SecurityImmutable security, TradeMessageImmutable trade, Func<SecurityImmutable?, uint> get_display_qty_divisor) {
          this.row_key = row_key;
          this.security = security;
          _trade = trade;
          trade_key = trade.Key;
+         _get_display_qty_divisor = get_display_qty_divisor ?? new Func<SecurityImmutable?, uint>(sec => 1);
       }
 
       public event Action invalidated;
@@ -39,6 +42,8 @@ namespace bts.shell.time_and_sales {
       public DateTime time => ((ulong)_trade.Time).lldatetime().ToLocalTime();
       public double price => _trade.price();
       public uint size => _trade.Size;
+      public uint display_size => _display_size ??
+         (_display_size = size.safe_divide(_get_display_qty_divisor(security))).Value;
       public AggressorSide aggressor_side => _trade.AggressorSide;
 
       public void raise_invalidated() =>

src/client/spark/Modules/Market/TimeAndSales/TimeAndSalesVM.cs

@@ -40,6 +40,7 @@ namespace bts.shell.time_and_sales {
          _refresh_filter,
          _refresh_sort,
          _refresh_selected_rows;
+      readonly Func<SecurityImmutable?, uint> _get_display_qty_divisor;
       IComparer<TimeAndSalesRowVM> _comparer_backing;
       Func<TimeAndSalesRowVM, bool> _filter_backing;
       ImmutableHashSet<TimeAndSalesRowVM> _selected_rows = ImmutableHashSet<TimeAndSalesRowVM>.Empty;
@@ -58,8 +59,9 @@ namespace bts.shell.time_and_sales {
          _filter_change_count,
          _sort_change_count;
 
-      public TimeAndSalesVM(IWindowSettingsManager<GridSettings> settings_manager) {
+      public TimeAndSalesVM(IWindowSettingsManager<GridSettings> settings_manager, Func<SecurityImmutable?, uint> get_display_qty_divisor) {
          _sort_manager = new ColumnSortManager(columns.WrapSelector(c => c as ISortableDIYGridColumn, null), TimeAndSalesView.Columns.RowKey.ToString());
+         _get_display_qty_divisor = get_display_qty_divisor ?? new Func<SecurityImmutable?, uint>(sec => 1);
          _comparer_backing = _sort_manager.BuildComparer(_get_column_comparer);
          _log = new LoggerContext(Log.Ui, $"Time And Sales VM ({Interlocked.Increment(ref _id_counter)})", null);
          _settings_manager = settings_manager;
@@ -95,7 +97,7 @@ namespace bts.shell.time_and_sales {
             System.Windows.HorizontalAlignment.Right);
          add_column(
             TimeAndSalesView.Columns.Size,
-            r => r.size.ToString(),
+            r => r.display_size.ToString(),
             DefaultColumnHeaders.Size,
             DefaultColumnWidths.Size,
             size_filter,
@@ -304,7 +306,7 @@ namespace bts.shell.time_and_sales {
          }
          var all_rows_bd = _all_rows.ToBuilder();
          foreach (var t in trades) {
-            var r = _row_factory.create(t.security, t.trade);
+            var r = _row_factory.create(t.security, t.trade, _get_display_qty_divisor);
             all_rows_bd.Add(r);
             if (_filter_backing == null || _filter_backing(r))
                rows.InsertSorted(r, _comparer);
@@ -400,11 +402,11 @@ namespace bts.shell.time_and_sales {
          // the row key must be unique to each row in the collection
          int _row_id_counter;
 
-         public TimeAndSalesRowVM create(TradeInfo trade_info) =>
-            new TimeAndSalesRowVM(_row_id_counter++, trade_info.security, trade_info.trade);
+         public TimeAndSalesRowVM create(TradeInfo trade_info, Func<SecurityImmutable?, uint> get_display_qty_divisor) =>
+            new TimeAndSalesRowVM(_row_id_counter++, trade_info.security, trade_info.trade, get_display_qty_divisor);
 
-         public TimeAndSalesRowVM create(SecurityImmutable security, TradeMessageImmutable trade) =>
-            new TimeAndSalesRowVM(_row_id_counter++, security, trade);
+         public TimeAndSalesRowVM create(SecurityImmutable security, TradeMessageImmutable trade, Func<SecurityImmutable?, uint> get_display_qty_divisor) =>
+            new TimeAndSalesRowVM(_row_id_counter++, security, trade, get_display_qty_divisor);
       }
    }
 }

src/client/spark/Modules/Market/TimeAndSales/TimeAndSalesWindow.cs

@@ -26,6 +26,7 @@ namespace bts.shell.time_and_sales {
       readonly TimeAndSalesWindowFactory _factory;
       readonly IWindowSettingsManager<GridSettings> _settings_manager;
       readonly bool _can_pause_updates;
+      readonly Func<SecurityImmutable?, uint> _get_display_qty_divisor;
       TimeAndSalesVM _vm;
       TimeAndSalesModel _model;
       SecurityCriteria _security_criteria_backing;
@@ -35,12 +36,21 @@ namespace bts.shell.time_and_sales {
       SparkMenuDisplayVM _menu_display_vm;
       IDisposable _subscriptions;
 
-      public TimeAndSalesWindow(TimeAndSalesWindowFactory factory, IBus bus, MDConsumer consumer, TimeAndSalesSettings state, ImageSource icon, IWindowSettingsManager<GridSettings> settings_manager, bool can_pause_updates)
+      public TimeAndSalesWindow(
+         TimeAndSalesWindowFactory factory,
+         IBus bus,
+         MDConsumer consumer,
+         TimeAndSalesSettings state,
+         ImageSource icon,
+         IWindowSettingsManager<GridSettings> settings_manager,
+         bool can_pause_updates,
+         Func<SecurityImmutable?, uint> get_display_qty_divisor)
          : base("Time And Sales", bus, factory, SparkCommands.ShowTimeAndSales.icon) {
          Log.assert(state != null);
          _consumer = consumer;
          _factory = factory;
          _state = state ?? TimeAndSalesSettings.Default(new SecurityCriteria());
+         _get_display_qty_divisor = get_display_qty_divisor ?? new Func<SecurityImmutable?, uint>(sec => 1);
          if (_state.security_criteria == null)
             _state = _state.with(new SecurityCriteria());
          _security_criteria_backing = _state.security_criteria;
@@ -86,7 +96,7 @@ namespace bts.shell.time_and_sales {
             _settings_manager.instance_settings = _state.grid;
          _menu_display_vm = new SparkMenuDisplayVM();
          _menu_display_vm.load_from(_state.menu_display);
-         _vm = new TimeAndSalesVM(_settings_manager);
+         _vm = new TimeAndSalesVM(_settings_manager, _get_display_qty_divisor);
          var selected_rows_src = Observable.Create<ImmutableHashSet<TimeAndSalesRowVM>>(o => {
             _vm.selected_rows_changed += o.OnNext;
             return Disposable.Create(() => _vm.selected_rows_changed -= o.OnNext);

src/client/spark/Modules/Market/TimeAndSalesWindowFactory.cs

@@ -20,12 +20,15 @@ namespace bts.shell {
       readonly MDConsumer _consumer;
       readonly UserSettingsHub _settings_hub;
       readonly TimeAndSalesConfig _time_and_sales_conf;
+      readonly ISecurityAuxiliaryDataModel _security_auxiliary_model;
       IReadOnlyDictionary<uint, SecurityMD> _securities = new Dictionary<uint, SecurityMD>();
 
-      public TimeAndSalesWindowFactory(IShellModule module, IBus bus, MDConsumer consumer, UserSettingsHub settings_hub) : base(module, "TimeAndSales") {
+      public TimeAndSalesWindowFactory(IShellModule module, IBus bus, MDConsumer consumer, UserSettingsHub settings_hub, ISecurityAuxiliaryDataModel security_auxiliary_model)
+         : base(module, "TimeAndSales") {
          _bus = bus;
          _consumer = consumer;
          _settings_hub = settings_hub;
+         _security_auxiliary_model = security_auxiliary_model;
          _time_and_sales_conf = new TimeAndSalesConfig(Configuration.get<bts.config.TimeAndSalesOptions>());
          _dispose = Disposable.Create(
             bus.subscribe(SparkTags.SecuritiesTag).Subscribe(s => _securities = s),
@@ -38,7 +41,8 @@ namespace bts.shell {
       public override Task<IShellWindow> load(TimeAndSalesSettings state) =>
          Task.FromResult<IShellWindow>(new TimeAndSalesWindow(this, _bus, _consumer, state, SparkCommands.PickTimeAndSales.icon,
             new WindowSettingsManager<GridSettings>(_settings_hub, state.grid, s => s.time_and_sales_grid, (s, g) => s.with(time_and_sales:g)),
-            _time_and_sales_conf.can_pause_updates));
+            _time_and_sales_conf.can_pause_updates,
+            _security_auxiliary_model.get_display_quantity_divisor));
 
       public async void show(SecurityCriteria criteria) {
          var w = await load(new TimeAndSalesSettings(criteria));

src/client/spark/Modules/Spreader/ExecutionStrategyEditor.xaml

@@ -549,24 +549,48 @@
               </u:BindingUpdateGroupCollection>
             </u:Behavior.BindingUpdateGroups>
           </TextBox>
-          <TextBlock
+          <StackPanel
             x:Name="PART_TickFactors_Label"
             Grid.Column="2"
-            VerticalAlignment="Center"
-            Margin="{StaticResource Margin.LHeaderPanelItem}"
-            Text="Ticks"
             IsEnabled="True"
+            Orientation="Horizontal"
             Visibility="{Binding LegTuples.Count, RelativeSource={RelativeSource TemplatedParent}, Converter={StaticResource IntNotZeroVisibilityConverter}}"
-          />
-          <c:TickFactorsPicker
+           >
+            <TextBlock
+              VerticalAlignment="Center"
+              Margin="{StaticResource Margin.LHeaderPanelItem}"
+              Text="Ticks ("
+            />
+            <CheckBox
+              Margin="1,0,0,0"
+              IsChecked="{Binding UseFractionalTicks, RelativeSource={RelativeSource TemplatedParent}}"
+              VerticalAlignment="Center"
+              VerticalContentAlignment="Center"
+              Padding="0"
+            >
+              fractional
+            </CheckBox>
+            <TextBlock VerticalAlignment="Center" Margin="1,0,0,0">)</TextBlock>
+          </StackPanel>
+          <Grid
             x:Name="PART_TickFactors_Picker"
             Grid.Column="3"
-            Margin="{StaticResource Margin.LHeaderPanelItem}"
-            HorizontalAlignment="Stretch"
             IsEnabled="True"
-            SelectedTickFactors="{Binding TickFactors, RelativeSource={RelativeSource TemplatedParent}, Mode=TwoWay}"
+            Margin="{StaticResource Margin.LHeaderPanelItem}"
             Visibility="{Binding LegTuples.Count, RelativeSource={RelativeSource TemplatedParent}, Converter={StaticResource IntNotZeroVisibilityConverter}}"
-          />
+          >
+            <c:TickFactorsPicker
+              HorizontalAlignment="Stretch"
+              SelectedTickFactors="{Binding TickFactors, RelativeSource={RelativeSource TemplatedParent}, Mode=TwoWay}"
+              Visibility="{Binding UseFractionalTicks, RelativeSource={RelativeSource TemplatedParent}, Converter={x:Static cv:BooleanToVisibilityConverter.HiddenInstance}}"
+            />
+            <c:TickUpDownInt
+              HorizontalAlignment="Stretch"
+              Minimum="1"
+              Value="{Binding IntegerTickSize, RelativeSource={RelativeSource TemplatedParent}}"
+              Visibility="{Binding UseFractionalTicks, RelativeSource={RelativeSource TemplatedParent}, Converter={StaticResource FalseVisibilityConverter}}"
+            />
+          </Grid>
           <TextBlock
             x:Name="PART_Pricing_Label"
             Grid.Column="4"

src/client/spark/Modules/Spreader/ExecutionStrategyEditor.xaml.cs

@@ -52,6 +52,26 @@ namespace mbts.ui.spark {
       public TickFactors TickFactors { get => GetValue(TickFactorsProperty) as TickFactors; set => SetValue(TickFactorsProperty, value); }
       #endregion
 
+      #region UseFractionalTicks
+      public static readonly DependencyProperty UseFractionalTicksProperty = WPFHelper.create_dp<bool, ExecutionStrategyEditor>(
+         nameof(UseFractionalTicks), FrameworkPropertyMetadataOptions.BindsTwoWayByDefault, true);
+
+      public bool UseFractionalTicks {
+         get => (bool)GetValue(UseFractionalTicksProperty);
+         set => SetValue(UseFractionalTicksProperty, value);
+      }
+      #endregion
+
+      #region IntegerTickSize
+      public static readonly DependencyProperty IntegerTickSizeProperty = WPFHelper.create_dp<int, ExecutionStrategyEditor>(
+         nameof(IntegerTickSize), FrameworkPropertyMetadataOptions.BindsTwoWayByDefault, 1);
+
+      public int IntegerTickSize {
+         get => (int)GetValue(IntegerTickSizeProperty);
+         set => SetValue(IntegerTickSizeProperty, value);
+      }
+      #endregion
+
       #region IsNew
       public static readonly DependencyProperty IsNewProperty =
          DependencyProperty.Register(

src/client/spark/Modules/Spreader/SyntheticEditorView.xaml

@@ -36,6 +36,8 @@
       ContractPickerModel="{Binding contract_picker_model}"
       HedgePricing="{Binding hedge_pricing}"
       HedgePricingItemsSource="{Binding hedge_pricing_options}"
+      UseFractionalTicks="{Binding use_fractional_ticks}"
+      IntegerTickSize="{Binding integer_tick_size}"
     />
     <c:DialogSkirtOKCancel Grid.Row="1" OKCommand="{Binding commit}" CloseOnOK="False"/>
   </Grid>

src/client/spark/Modules/Spreader/VM/SyntheticEditorVM.cs

@@ -2,7 +2,6 @@
 using bts.collections;
 using bts.shell;
 using bts.spark;
-using bts.utils;
 using mbts.ui;
 using mbts.ui.shell;
 using mbts.ui.spark;
@@ -30,8 +29,16 @@ namespace mbts.spark {
       readonly Property<bool> _has_working_orders, _can_add_leg;
 
       Security _synthetic;
-      bool _set_name_automatically, _set_ticks_automatically, _set_quantities_automatically, _set_price_mults_automatically, _is_setting_quantities, _is_setting_price_mults;
+      bool
+         _set_name_automatically,
+         _set_ticks_automatically,
+         _set_quantities_automatically,
+         _set_price_mults_automatically,
+         _is_setting_quantities,
+         _is_setting_price_mults,
+         _use_fractional_ticks = true;
       TickFactors _tick_factors;
+      int _integer_tick_size = 1;
       ExecutionStrategyImmutable _strategy;
       HedgePricing _hedge_pricing;
 
@@ -44,6 +51,10 @@ namespace mbts.spark {
          : this(synthetic, strategy, false) {
          ExceptionAssert.InvalidOperation.That(synthetic.Id != 0, "This constructor may only be used for already-existing synthetic securities (id must be non-zero).");
          _tick_factors = TickUtils.get_regional_ticks(synthetic.ContractSpec).low_tick;
+         if (TickUtils.is_integer_tick(synthetic.ContractSpec)) {
+            _use_fractional_ticks = false;
+            _integer_tick_size = DoubleHelper.to_optional_int32(synthetic.ContractSpec.LowTick) ?? 0;
+         }
          title = $"Edit '{synthetic.Synthetic.Name}'";
          icon = Icons.ModifySynthetic;
          _has_working_orders = backing(nameof(has_working_orders), security_has_working_orders.OnDispatcher());
@@ -131,14 +142,14 @@ namespace mbts.spark {
                flash_error_msg("Name already taken", SparkUtils.UI.MessageFlashDuration, nameof(name)).ignore();
                valid = false;
             }
-            if (_tick_factors == null || !_tick_factors.is_valid()) {
-               flash_error_msg("Please select ticks", SparkUtils.UI.MessageFlashDuration, nameof(tick_factors)).ignore();
+            if (use_fractional_ticks ? (_tick_factors == null || !_tick_factors.is_valid()) : integer_tick_size == 0) {
+               flash_error_msg("Please select ticks", SparkUtils.UI.MessageFlashDuration, use_fractional_ticks ? nameof(tick_factors) : nameof(integer_tick_size)).ignore();
                valid = false;
             }
             if (valid) {
                _synthetic.Synthetic.Legs.SetItems(leg_tuples.Select(l => l.leg));
                _synthetic.Symbol = _deduce_symbol(_synthetic);
-               _synthetic.ContractSpec = _tick_factors.to_spec();
+               _synthetic.ContractSpec = use_fractional_ticks ? _tick_factors.to_spec() : TickUtils.create_integer_tick_spec(integer_tick_size);
                uint? id = await model.create_synthetic(new SecurityImmutable(_synthetic));
                if (id.HasValue && id != 0) {
                   if (await model.save_strategy(id.Value, get_strategy())) {
@@ -295,6 +306,20 @@ namespace mbts.spark {
       public bool has_working_orders => _has_working_orders.Value;
       public bool is_new { get; }
       public bool is_new_leg_popup_open { get; set; }
+      public bool use_fractional_ticks {
+         get => _use_fractional_ticks;
+         set {
+            if (Set(ref _use_fractional_ticks, value))
+               _set_ticks_automatically = false;
+         }
+      }
+      public int integer_tick_size {
+         get => _integer_tick_size;
+         set {
+            if (Set(ref _integer_tick_size, value))
+               _set_ticks_automatically = false;
+         }
+      }
       public bool can_add_leg => _can_add_leg.Value;
       public SyntheticContract.Types.PriceCalc price_calc { get => _synthetic.Synthetic.PriceCalc; set => _synthetic.Synthetic.PriceCalc = value; }
       public ObservableCollection<LegSpreaderParamsTuple> leg_tuples { get; } = new ObservableCollection<LegSpreaderParamsTuple>();
@@ -323,6 +348,16 @@ namespace mbts.spark {
          _strategy = strategy;
          hedge_pricing = strategy.HedgePricing;
          leg_tuples.SetItems(_get_legs(_synthetic, strategy));
+         if (synthetic.HasContractSpec) {
+            /// assign the fields <see cref="_use_fractional_ticks"/> and <see cref="_integer_tick_size"/>,
+            /// rather than the properties <see cref="use_fractional_ticks"/> and <see cref="integer_tick_size"/>
+            /// because the setters of the former flip <see cref="_set_ticks_automatically"/> to false if the value changes.
+            /// This behavior causes the ticks to be automatically deduced as legs are added/removed,
+            /// until the user explicitly enters a different value (as the properties are bound to tick input controls in the view).
+            Set(ref _use_fractional_ticks, !TickUtils.is_integer_tick(synthetic.ContractSpec), nameof(use_fractional_ticks));
+            if (!use_fractional_ticks)
+               Set(ref _integer_tick_size, DoubleHelper.to_optional_int32(synthetic.ContractSpec.LowTick) ?? 0, nameof(integer_tick_size));
+         }
          RaisePropertyChanged(nameof(name), nameof(tick_factors));
       }
 

src/client/spark/Modules/Trading/AlgoStudio/VM/AlgoDefinitionVM.cs

@@ -236,12 +236,20 @@ namespace mbts.spark {
          get => algo_root;
          set => algo_root = value;
       }
+      IAlgoVM IAlgoParamVM<IAlgoVM>.display_value {
+         get => algo_root;
+         set => algo_root = value;
+      }
       bool IAlgoParamVM.has_value => _algo_root != null;
       bool IAlgoParamVM.is_enabled { get; set; } = true;
       object IAlgoParamVM.value {
          get => algo_root;
          set => algo_root = (IAlgoVM)value;
       }
+      object IAlgoParamVM.display_value {
+         get => algo_root;
+         set => algo_root = (IAlgoVM)value;
+      }
       AlgoParamPermissions _permissions = AlgoParamPermissions.ReadWrite;
       AlgoParamPermissions IAlgoParamVM.permissions { get => _permissions; set => _permissions = value; }
 

src/client/spark/Modules/Trading/AlgoStudio/View/AlgoEditorGridView/AlgoEditorGridView.xaml

@@ -199,18 +199,30 @@
                 Grid.Column="1"
                 HorizontalAlignment="Center"
                 Foreground="{u:BTSColor MarketData.bid}"
-                Text="{Binding DataContext.bbo.bid_size, RelativeSource={RelativeSource AncestorType=usp:AlgoEditorGridView}}"
                 ToolTip="Best Bid Size"
-              />
+              >
+                <TextBlock.Text>
+                  <MultiBinding Converter="{x:Static cv:DynamicDoubleDivisorConverter.Instance}">
+                    <Binding Path="DataContext.bbo.bid_size" RelativeSource="{RelativeSource AncestorType=usp:AlgoEditorGridView}" Mode="OneWay"/>
+                    <Binding Path="DataContext.display_quantity_divisor" RelativeSource="{RelativeSource AncestorType=usp:AlgoEditorGridView}" Mode="OneWay"/>
+                  </MultiBinding> 
+                </TextBlock.Text>
+              </TextBlock>
               <TextBlock
                 x:Name="ask_text"
                 Grid.Column="2"
                 HorizontalAlignment="Center"
                 Margin="4,0"
                 Foreground="{u:BTSColor MarketData.ask}"
-                Text="{Binding DataContext.bbo.ask_size, RelativeSource={RelativeSource AncestorType=usp:AlgoEditorGridView}}"
                 ToolTip="Best Ask Size"
-              />
+              >
+                <TextBlock.Text>
+                  <MultiBinding Converter="{x:Static cv:DynamicDoubleDivisorConverter.Instance}">
+                    <Binding Path="DataContext.bbo.ask_size" RelativeSource="{RelativeSource AncestorType=usp:AlgoEditorGridView}" Mode="OneWay"/>
+                    <Binding Path="DataContext.display_quantity_divisor" RelativeSource="{RelativeSource AncestorType=usp:AlgoEditorGridView}" Mode="OneWay"/>
+                  </MultiBinding> 
+                </TextBlock.Text>
+              </TextBlock>
             </Grid>
             <DataTemplate.Triggers>
               <DataTrigger Binding="{Binding path_disambiguation}" Value="{x:Static sys:String.Empty}">
@@ -272,6 +284,14 @@
               </Grid>
             </DataTemplate>
           </u:TemplateSelectorKeyValue>
+          <!--TODO: replace all the param.value bindings with param.display_value.
+              The reason this has not already been done is that the display_value property is new,
+              and only necessary for the size param as of 6/8/2020 (slightly more uniform code doesn't warrant rocking the boat).-->
+          <u:TemplateSelectorKeyValue Key="{x:Static usp:AlgoParamTemplateKeys.Size}">
+            <DataTemplate>
+              <TextBlock Text="{Binding param.display_value}"/>
+            </DataTemplate>
+          </u:TemplateSelectorKeyValue>
         </usp:AlgoParamTemplateSelector.KeyedTemplates>
         <!--Bool-->
         <usp:AlgoParamTemplateSelector.BoolTemplate>
@@ -360,6 +380,22 @@
               />
             </DataTemplate>
           </u:TemplateSelectorKeyValue>
+          <!--TODO: replace all the param.value bindings with param.display_value.
+              The reason this has not already been done is that the display_value property is new,
+              and only necessary for the size param as of 6/8/2020 (slightly more uniform code doesn't warrant rocking the boat).-->
+          <u:TemplateSelectorKeyValue Key="{x:Static usp:AlgoParamTemplateKeys.Size}">
+            <DataTemplate>
+              <c:TickUpDownNullableInt Focusable="False" HorizontalAlignment="Stretch" Value="{Binding param.display_value, UpdateSourceTrigger=PropertyChanged}" ArrowKeyTickModifiers="Ctrl">
+                <c:TickUpDownNullableInt.CommandBindings>
+                  <CommandBinding Command="{x:Static u:NavigationHelper.MoveFocusCommand}" Executed="{x:Static u:NavigationHelper.KeyboardMoveFocusExecuted}"/>
+                </c:TickUpDownNullableInt.CommandBindings>
+                <c:TickUpDownNullableInt.InputBindings>
+                  <KeyBinding Key="Up" Command="{x:Static u:NavigationHelper.MoveFocusCommand}" CommandParameter="{x:Static FocusNavigationDirection.Up}"/>
+                  <KeyBinding Key="Down" Command="{x:Static u:NavigationHelper.MoveFocusCommand}" CommandParameter="{x:Static FocusNavigationDirection.Down}"/>
+                </c:TickUpDownNullableInt.InputBindings>
+              </c:TickUpDownNullableInt>
+            </DataTemplate>
+          </u:TemplateSelectorKeyValue>
         </usp:AlgoParamTemplateSelector.KeyedTemplates>
         <!--Bool-->
         <usp:AlgoParamTemplateSelector.BoolTemplate>

src/client/spark/Modules/Trading/Fills/FillsVM.cs

@@ -122,7 +122,7 @@ namespace mbts.spark {
          add_col(Columns.Account, DefaultColumnHeaders.Account, r => r.account, dv_filter_rx(_model.factory.subscribe_accounts().Select(d => d.Values.Ordered()), r => r.account), DataGridFilterKnownTemplates.DiscreteValues, DefaultColumnWidths.Account);
          add_col(Columns.Exchange, DefaultColumnHeaders.Exchange, r => r.exchange.ToString(), dv_filter(EnumHelper.get_values<Venue>().ToArray(), r => r.security.exchange_or_default()), DataGridFilterKnownTemplates.DiscreteValues, DefaultColumnWidths.Exchange);
          add_col(Columns.TimeInForce, DefaultColumnHeaders.TimeInForce, r => r.time_in_force.ToString(), dv_filter(EnumHelper.get_values<TimeInForce>().ToArray(), r => r.order?.time_in_force() ?? TimeInForce.Undefined), DataGridFilterKnownTemplates.DiscreteValues, DefaultColumnWidths.TimeInForce);
-         add_col(Columns.Size, DefaultColumnHeaders.Size, r => r.size.ToString(), new DoubleMinMax<FillTuple>(r => r.fill.LastShares), DataGridFilterKnownTemplates.UIntMinMax, DefaultColumnWidths.Size);
+         add_col(Columns.Size, DefaultColumnHeaders.Size, r => r.display_size.ToString(), new DoubleMinMax<FillTuple>(r => r.fill.LastShares), DataGridFilterKnownTemplates.UIntMinMax, DefaultColumnWidths.Size);
          add_col(Columns.Price, DefaultColumnHeaders.Price, r => r.format_price(r.price), new DoubleMinMax<FillTuple>(r => r.fill.LastPrice), DataGridFilterKnownTemplates.DoubleMinMax, DefaultColumnWidths.Price);
          add_col(Columns.FillKind, DefaultColumnHeaders.FillKind, r => r.fill_kind.ToString(), dv_filter(EnumHelper.get_values<FillKind>().ToArray(), r => r.fill.FillKind), DataGridFilterKnownTemplates.DiscreteValues, DefaultColumnWidths.FillKind);
          add_col(Columns.FillStatus, DefaultColumnHeaders.FillStatus, r => r.fill_status.ToString(), dv_filter(EnumHelper.get_values<FillStatus>().ToArray(), r => r.fill.FillStatus), DataGridFilterKnownTemplates.DiscreteValues, DefaultColumnWidths.FillKind);
@@ -286,6 +286,7 @@ namespace mbts.spark {
          Color? _root_algo_badge_color;
          OrderMetadata _order_metadata;
          bool _is_selected;
+         double? _display_size;
 
          public Row(FillTuple fill_tuple, OrdersModel model) : 
             base(fill_tuple.security ?? SecurityDataHelper.Defaults.SecurityImmutable) {
@@ -306,6 +307,8 @@ namespace mbts.spark {
          public Side side => _fill.Side;
          public double price => _fill.LastPrice;
          public double size => _fill.LastShares;
+         public double display_size => _display_size ??
+            (_display_size = size.safe_divide(_model.security_auxiliary_model.get_display_quantity_divisor(security))).Value;
          public FillKind fill_kind => _fill.FillKind;
          public FillStatus fill_status => _fill.FillStatus;
          public string fill_key => _fill.FillKey;

src/client/spark/Modules/Trading/Ladder/LadderSettings.cs

@@ -87,6 +87,15 @@ namespace mbts.spark {
       public static bool operator !=(LadderColumnSettings x, LadderColumnSettings y) => !(x == y);
    }
 
+   [ProtoContract]
+   class LadderOrderLimits : IEquatable<LadderOrderLimits> {
+      [ProtoMember(1)]
+      public ToggleInt32Proto max_settlement_cross_ticks { get; set; }
+
+      public bool Equals(LadderOrderLimits other) =>
+         other != null && max_settlement_cross_ticks == other.max_settlement_cross_ticks;
+   }
+
    [ProtoContract]
    class HistogramBarAnimation : IEquatable<HistogramBarAnimation> {
       // this class is 100% mutable (there are literally 0 readonly members),
@@ -314,6 +323,8 @@ namespace mbts.spark {
    // Settings are liable to change in the near future, so an internal IEqualityComparer simply won't do as it risks becoming out of date.
    [ProtoContract]
    class LadderSettings : IEquatable<LadderSettings> {
+      // RESERVED ProtoMember indices
+      //    900-999: dj settings
       const double _default_order_entry_panel_width = 110.0;
       const double _default_zoom_factor = 1.0;
       const bool _default_show_warn_on_cross = true;
@@ -592,6 +603,9 @@ namespace mbts.spark {
       [ProtoMember(61), DefaultValue(true)]
       public bool status_message_visible { get; set; }
 
+      [ProtoMember(900)]
+      public LadderOrderLimits ladder_order_limits { get; set; }
+
       public void sanitize() =>
          sanitize(this);
 
@@ -697,7 +711,8 @@ namespace mbts.spark {
          a.enforce_max_clip == b.enforce_max_clip &&
          a.max_clip == b.max_clip &&
          a.price_display_format == b.price_display_format &&
-         a.status_message_visible == b.status_message_visible;
+         a.status_message_visible == b.status_message_visible &&
+         a.ladder_order_limits.safe_equals(b.ladder_order_limits);
 
       public bool Equals(LadderSettings other) =>
          profile_equals(this, other) &&

src/client/spark/Modules/Trading/Ladder/LadderWindowFactory.cs

@@ -100,6 +100,7 @@ namespace bts.shell {
          ShellWindowVM shell_window_vm = null;
          IShellWindow shell_window = null;
          var title_source = new LazyObservable<string>(() => ShellWindowExtensions.literal_title_source(shell_window, shell_window_vm));
+         LadderVM vm = null;
          var view = new Lazy<UIElement>(() => {
             // resources
             var model = new LadderModel(md, _orders_model, _mbo);
@@ -113,7 +114,6 @@ namespace bts.shell {
             /// In response to that event, 'needs_resync' is set to true. This causes 'last_value' to be refreshed when the next caller requests the latest settings
             /// (i.e., an IObserver subscribing to the settings_source, or the settings-dialog viewmodel).
             bool initialized = false, needs_resync = false;
-            LadderVM vm = null;
             var settings_subject = new Subject<LadderSettings>();
             var settings_source = Observable.Create<LadderSettings>(o => {
                ensure_synced();
@@ -272,10 +272,11 @@ namespace bts.shell {
             (v, s) => save(_get_state(((LadderView)v).vm, settings_id), s),
             icon: Icons.Ladder,
             thread_id: _thread_id_provider.next_id(),
-            vm => {
-               shell_window_vm = vm;
+            swvm => {
+               shell_window_vm = swvm;
                title_source.connect();
-            });
+            },
+            key_event_args => vm?.key_down(key_event_args));
       }
 
       async void _show_windows(IImmutableSet<uint> securities) {

src/client/spark/Modules/Trading/Ladder/VM/LadderOrderVM.cs

@@ -4,6 +4,7 @@ using bts.shell.orderbook;
 using mbts.persist;
 using mbts.ui;
 using mbts.ui.shell;
+using mbts.ui.spark;
 using System;
 using System.Collections;
 using System.Collections.Generic;
@@ -169,7 +170,8 @@ namespace mbts.spark {
       }
 
       private void _set_badge_text() {
-         text_lines = BadgeRender.format(side, quantity, filled, _current_badge_style);
+         var fmt = MDDisplayHelper.get_value_formatter(_owner.display_quantity_divisor);
+         text_lines = BadgeRender.format(side, quantity, filled, _current_badge_style, fmt);
          RaisePropertyChanged(nameof(text_lines));
       }
 

src/client/spark/Modules/Trading/Ladder/VM/LadderSettingsVM.cs

@@ -3,6 +3,7 @@ using bts.api;
 using bts.api.orderman;
 using bts.collections;
 using bts.persist.algo;
+using bts.proto;
 using bts.shell.orderbook;
 using bts.utils;
 using mbts.collections;
@@ -44,7 +45,8 @@ namespace mbts.spark {
       LadderSettings.NetChangeTerms _price_format;
       LadderSettings.PriceDisplayFormat _price_display_format;
       double _order_entry_panel_width, _zoom_factor;
-      bool _auto_clear, _show_warn_on_cross, _enforce_max_clip;
+      bool _auto_clear, _show_warn_on_cross, _enforce_max_clip, _enforce_max_settlement_cross_ticks;
+      int _max_settlement_cross_ticks;
       LadderSettings _current;
       LadderColumnSettingsVM
          _orders = new OrdersColumnSettingsVM(),
@@ -190,6 +192,8 @@ namespace mbts.spark {
       public bool show_warn_on_cross { get => _show_warn_on_cross; set => Set(ref _show_warn_on_cross, value); }
       public bool enforce_max_clip { get => _enforce_max_clip; set => Set(ref _enforce_max_clip, value); }
       public uint max_clip { get => _max_clip.Value; set => _max_clip.Value = value; }
+      public bool enforce_max_settlement_cross_ticks { get => _enforce_max_settlement_cross_ticks; set => Set(ref _enforce_max_settlement_cross_ticks, value); }
+      public int max_settlement_cross_ticks { get => _max_settlement_cross_ticks; set => Set(ref _max_settlement_cross_ticks, value); }
 
       // favorites
       public FavoriteAlgosVM favorite_algos_vm { get; }
@@ -370,6 +374,10 @@ namespace mbts.spark {
             show_warn_on_cross = settings.show_warn_on_cross;
             enforce_max_clip = settings.enforce_max_clip;
             max_clip = settings.max_clip;
+            if (settings.ladder_order_limits != null) {
+               enforce_max_settlement_cross_ticks = settings.ladder_order_limits.max_settlement_cross_ticks.is_enabled;
+               max_settlement_cross_ticks = settings.ladder_order_limits.max_settlement_cross_ticks.value;
+            }
          }
       }
 
@@ -448,6 +456,10 @@ namespace mbts.spark {
          clone.show_warn_on_cross = show_warn_on_cross;
          clone.enforce_max_clip = enforce_max_clip;
          clone.max_clip = max_clip;
+         if (clone.ladder_order_limits == null)
+            clone.ladder_order_limits = new LadderOrderLimits();
+         clone.ladder_order_limits.max_settlement_cross_ticks =
+            new ToggleInt32Proto(max_settlement_cross_ticks, enforce_max_settlement_cross_ticks);
          return clone;
       }
 

src/client/spark/Modules/Trading/Ladder/VM/LadderVM.cs

@@ -1,6 +1,6 @@
 using bts.api;
 using bts.api.orderman;
-using bts.collections;
+using bts.proto;
 using bts.shell;
 using bts.spark;
 using bts.utils;
@@ -8,6 +8,7 @@ using mbts.co2;
 using mbts.spark.utilities;
 using mbts.ui;
 using mbts.ui.shell;
+using mbts.ui.spark;
 using mbts.utils;
 using System;
 using System.Collections.Generic;
@@ -66,6 +67,8 @@ namespace mbts.spark {
          current_settings = init;
          this.settings = settings;
          _equality = TickUtils.tick_equality_comparer(_model.security.ContractSpec);
+         display_quantity_divisor = model.order_gateway.security_auxiliary_model.get_display_quantity_divisor(model.security);
+         size_calculator.display_divisor = display_quantity_divisor;
          _slot_price_vs_orders = new Dictionary<double, LadderOrderVM>(_equality);
          this.order_properties_vm = order_properties_vm;
          _high = backing(nameof(high), double.NaN);
@@ -257,7 +260,11 @@ namespace mbts.spark {
 
       public IBus bus => _bus;
 
-      public event Action on_tick, request_settings_dialog, settings_invalidated;
+      public event Action
+         on_tick,
+         request_settings_dialog,
+         request_recenter,
+         settings_invalidated;
 
       public MDConsumerHandle md => _model.md;
       // we return only entries who have piqs and whose piqs are not uint.Max
@@ -292,6 +299,7 @@ namespace mbts.spark {
          remove => _on_disposed_impl -= value;
       }
       public SecurityImmutable security => _model.security;
+      public uint display_quantity_divisor { get; }
       public LadderSettings current_settings { get; private set; }
       public double high => _high.Value;
       public double low => _low.Value;
@@ -369,14 +377,14 @@ namespace mbts.spark {
          get {
             string rv = null;
             if (show_day_position)
-               rv = SparkUtils.fmt_position(day_position);
+               rv = SparkUtils.fmt_position(day_position / display_quantity_divisor);
             if (show_raw_day_position) {
-               var raw_day_text = SparkUtils.fmt_position(raw_day_position);
+               var raw_day_text = SparkUtils.fmt_position(raw_day_position / display_quantity_divisor);
                rv = rv == null ? raw_day_text : $"{rv} / {raw_day_text}";
             }
             if (show_account_position) {
-               var acc_text = SparkUtils.fmt_position(position);
-               rv = rv == null ? SparkUtils.fmt_position(position) : $"{rv} ({acc_text})";
+               var acc_text = SparkUtils.fmt_position(position / display_quantity_divisor);
+               rv = rv == null ? acc_text : $"{rv} ({acc_text})";
             }
             return rv ?? "";
          }
@@ -444,15 +452,27 @@ namespace mbts.spark {
       public void key_down(KeyEventArgs e) {
          if (order_properties_vm == null)
             return;
-         if (KeyboardExtensions.IsDown(Key.Space)) {
-            _bus?.post(SparkTags.RequestRecenterLadder, null);
-         }
-         // the ctrl modifier requirement helps avoid keyboard-input collisions w/ algo-templates popup
-         if (!KeyboardExtensions.IsCtrlDown()) return;
-         var new_algo = order_properties_vm.algo_definitions.FirstOrDefault(o => o.algo_root.key_match(e));
-         if (new_algo != null) {
-            order_properties_vm.selected_algo_definition = new_algo;
-            e.Handled = true;
+         switch (e.Key) {
+            case Key.Space:
+               if (KeyboardExtensions.IsShiftDown()) {
+                  // only recenter this ladder
+                  request_recenter?.Invoke();
+               } else {
+                  // recenter all ladders
+                  _bus?.post(SparkTags.RequestRecenterLadder, null);
+               }
+               e.Handled = true;
+               break;
+            default:
+               // the ctrl modifier requirement helps avoid keyboard-input collisions w/ algo-templates popup
+               if (KeyboardExtensions.IsCtrlDown()) {
+                  var new_algo = order_properties_vm.algo_definitions.FirstOrDefault(o => o.algo_root.key_match(e));
+                  if (new_algo != null) {
+                     order_properties_vm.selected_algo_definition = new_algo;
+                     e.Handled = true;
+                  }
+               }
+               break;
          }
       }
 
@@ -486,6 +506,10 @@ namespace mbts.spark {
       }
 
       public async Task send_order_async(Side side, uint size, double price) {
+         if (!_validate_price(side, price, out var invalid_price_msg)) {
+            status_update(new Activity { security = security, message = invalid_price_msg, category = ActivityLogCategory.order });
+            return;
+         }
          var order = order_properties_vm.create(side);
          if (order.CustomDef != null) {
             if (order.CustomDef.Stop != null) {
@@ -517,6 +541,23 @@ namespace mbts.spark {
          }
       }
 
+      bool _validate_price(Side side, double price, out string msg) {
+         msg = null;
+         if (!price.is_real()) {
+            msg = "not a real number";
+         } else if (settlement.is_real()) {
+            var ticks_from_settle = security.ContractSpec.tickdiff(price, settlement);
+            if (ticks_from_settle.HasValue) {
+               var max_cross = (current_settings?.ladder_order_limits?.max_settlement_cross_ticks)?.as_nullable();
+               if (max_cross.HasValue) {
+                  if (side == Side.Sell ? ticks_from_settle < (-1 * max_cross.Value) : ticks_from_settle > max_cross.Value)
+                     msg = $"exceeds settle cross ticks limit ({ticks_from_settle.Value})";
+               }
+            }
+         }
+         return msg == null;
+      }
+
       void _update_header() {
          bool last_updated = md.get_last_trade(ref _last_trade_time, out NativePriceSize last, out DateTime time, out ulong volume);
          if (_misc_time != _model.md.misc_timestamp || last_updated) {

src/client/spark/Modules/Trading/Ladder/VM/LadderVMContainer.cs

@@ -46,12 +46,12 @@ namespace mbts.spark {
       void _reset_ladder_vm() {
          if (_value == null && !_security_md.HasValue)
             return;
-         Disposable.replace(ref _value,
-            _security_md.HasValue ?
-               LadderVM.create_readonly(_bus,
-                  new LadderModel(security_md.Value, _model, _model.mbo_service,
-                  new Func<OrderSecurity, bool>(osec => _selected_order_tree.Contains(osec.order.Key))),
-                  Observable.Return(LadderSettings.sanitize(LadderSettings.Default))) : null);
+         _value?.Dispose();
+         _value = _security_md.HasValue ?
+            LadderVM.create_readonly(_bus,
+               new LadderModel(security_md.Value, _model, _model.mbo_service,
+               new Func<OrderSecurity, bool>(osec => _selected_order_tree.Contains(osec.order.Key))),
+               Observable.Return(LadderSettings.sanitize(LadderSettings.Default))) : null;
          RaisePropertyChanged(nameof(value));
       }
    }

src/client/spark/Modules/Trading/Ladder/View/LadderGridHost.cs

@@ -53,7 +53,7 @@ namespace mbts.spark {
       readonly RefValueContainer<IEnumerable<VolumeAtPriceLevelImmutable>> _volume_container =
          new RefValueContainer<IEnumerable<VolumeAtPriceLevelImmutable>>();
 
-      IDisposable _settings_sub, _volume_sub, _tick_sub;
+      IDisposable _settings_sub, _volume_sub, _tick_sub, _vm_sub;
       ScrollViewer _scrollViewer;
       LadderSettings _settings;
       LadderVM _vm;
@@ -66,7 +66,8 @@ namespace mbts.spark {
       double _last_origin_price;
       MarketBreakLines _mkt_break_lines;
       NativePriceSize _last_trade;
-      Func<NativePriceSize, string> _fmt_size = MDDisplayHelper.get_formatter_nps(MarketSizeDisplay.get_default());
+      Func<NativePriceSize, string> _fmt_mkt_depth_item_impl = MDDisplayHelper.get_formatter_nps(MarketSizeDisplay.get_default());
+      Func<uint, string> _fmt_mkt_quantity_impl = v => v.ToString();
       int _old_tooltip_row = int.MaxValue;
       NativePriceSize? _old_last_trade;
       string _direction_arrow = string.Empty;
@@ -468,7 +469,7 @@ namespace mbts.spark {
             security_id: _vm.model.security.Id,
             price_level: price_for_point(point)
          );
-         var model = new MBOPopupModel(_vm.model.mbo_service, _vm.model.security, query);
+         var model = new MBOPopupModel(_vm.model.mbo_service, _vm.model.security, query, fmt_mbo_qty);
          // Load the first set of orders so we know if there are any before showing the popup
          var result = await model.load_orders();
          if (result.success && result.value.orders.Count > 0) {
@@ -489,6 +490,8 @@ namespace mbts.spark {
             };
             view.RequestClose += (o, _) => popup.IsOpen = false;
          }
+         string fmt_mbo_qty(int value) =>
+            value < 0 ? $"-{_fmt_mkt_quantity((uint)value)}" : _fmt_mkt_quantity((uint)value);
       }
 
       protected override void OnMouseDoubleClick(MouseButtonEventArgs e) {
@@ -534,14 +537,44 @@ namespace mbts.spark {
          _size_from_row(row, _price_list, _asks, _vm.security.ContractSpec);
 
       uint _volume_from_row(int row) {
-         if (_price_list != null) {
-            var price = _price_list[row];
-            var vapls = _volume_container.read_new_value();
-            if (vapls != null) {
-               return vapls.SelectFirstOrDefault(v => MathUtils.epsilon_equals(v.Price, price), v => v.Volume);
-            } 
+         const int max_tries = 3;
+         var errors = new List<string>(0);
+         int num_tries = 0;
+         for (; num_tries < max_tries; num_tries++) {
+            try {
+               var rv = impl();
+               if (num_tries > 0) {
+                  log_errors(true);
+               }
+               return rv;
+            } catch (Exception ex) {
+               errors.Add(ex.ToString());
+            }
+         }
+         log_errors(false);
+         return 0;
+
+         void log_errors(bool succeeded) {
+            // Only log distinct errors to avoid useless noise.
+            // It's likely that the exception will always be the same (IndexOutOfRange),
+            // however, this bug is not fully understood, so assume nothing.
+            var error_msg = string.Join("; ", errors.Distinct());
+            if (succeeded) {
+               Log.Ui.error($"Ladder '{security}' got volume for row at index '{row}' after {num_tries + 1} attempts (price_list array length is {_price_list.Length}).  The following exceptions were observed: {error_msg}");
+            } else {
+               Log.Ui.error($"Ladder '{security}' failed to get volume for row at index '{row}' after {max_tries} attempts (price_list array length is {_price_list.Length}): {error_msg}");
+            }
+         }
+
+         uint impl() {
+            if (_price_list.SafeTryGetAt(row, out var price)) {
+               var vapls = _volume_container.read_new_value();
+               if (vapls != null) {
+                  return vapls.SelectFirstOrDefault(v => MathUtils.epsilon_equals(v.Price, price), v => v.Volume);
+               }
+            }
+            return 0u;
          }
-         return 0u;
       }
 
 
@@ -626,7 +659,7 @@ namespace mbts.spark {
             }
             void render_market_col(NativePriceSize[] depth) {
                var mid = LadderRender.index_of(_price_list, _last_origin_price, _price_comparer);
-               LadderRender.render_sizes(column.visual_tup.visual, column.visual_tup.glyph_context, mid, _price_list, depth, _settings.row_height, security.ContractSpec, column.settings, _fmt_size);
+               LadderRender.render_sizes(column.visual_tup.visual, column.visual_tup.glyph_context, mid, _price_list, depth, _settings.row_height, security.ContractSpec, column.settings, _fmt_mkt_depth_item);
             }
          }
          _apply_column_visual_offset();
@@ -664,10 +697,22 @@ namespace mbts.spark {
             _price_comparer = Comparer<double>.Create((x, y) => security.ContractSpec.tick_equals(x, y) ? 0 : y.CompareTo(x));
             _price_dirty = true;
             _piq_dirty = true;
-            _vm.on_tick += _tick;
+            // **use local vm to protect against re-assignment,
+            // so the events are unhooked from the same instance to which they were added
+            // when the subs are disposed.
+            var local_vm = _vm;
+            local_vm.on_tick += _tick;
+            local_vm.request_recenter += on_request_recenter;
             _settings_sub = _vm.settings.OnDispatcher().Subscribe(_settings_updated);
             _volume_sub = _vm.model.order_gateway.md_auxiliary_model.security_volume_at_price(security.Id).Subscribe(t => _volume_container.write_value(t.state.Values));
-            _tick_sub = Disposable.Create(() => _vm.on_tick -= _tick);
+            // **unhook from local_vm.request_recenter.
+            // todo: organize these subs into a single entity, prob _vm_subs.
+            // This hasn't already been done bc the ladder a bit fragile, so changes must be carefully implemented,
+            // with meticulous attention to detail.
+            _tick_sub = Disposable.Create(() => local_vm.on_tick -= _tick);
+            _vm_sub = Disposable.Create(() => local_vm.request_recenter -= on_request_recenter);
+            void on_request_recenter() =>
+               RecenterCommand?.ExecuteIfCan(null);
          }
       }
 
@@ -704,7 +749,7 @@ namespace mbts.spark {
                   _hide_tool_tip();
                }
 
-               tooltip_view.Content = $"{volume}";
+               tooltip_view.Content = _fmt_mkt_quantity(volume);
                tooltip_view.IsOpen = true;
                this.ToolTip = tooltip_view;
             } else {
@@ -820,7 +865,7 @@ namespace mbts.spark {
                if (last_trade_changed) {
                   var last_index = LadderRender.index_of(_price_list, _last_trade.price, _price_comparer);
                   if (last_index > 0)
-                     LadderRender.render_last(_last_vis_tup.visual, _last_vis_tup.glyph_context, _last_trade, last_index, _settings.row_height, _settings.last_column);
+                     LadderRender.render_last(_last_vis_tup.visual, _last_vis_tup.glyph_context, _last_trade, last_index, _settings.row_height, _settings.last_column, _fmt_mkt_quantity);
                }
                if (depth_changed)
                   _refresh_sizes();
@@ -862,21 +907,21 @@ namespace mbts.spark {
       void _refresh_last_trade() {
          var last_index = LadderRender.index_of(_price_list, _last_trade.price, _price_comparer);
          if (last_index > 0)
-            LadderRender.render_last(_last_vis_tup.visual, _last_vis_tup.glyph_context, _last_trade, last_index, _settings.row_height, _settings.last_column);
+            LadderRender.render_last(_last_vis_tup.visual, _last_vis_tup.glyph_context, _last_trade, last_index, _settings.row_height, _settings.last_column, _fmt_mkt_quantity);
       }
 
       void _refresh_piq() {
          if (!_settings.piq_column.show)
             return;
          int origin_index = LadderRender.index_of(_price_list, _mkt_break_lines.origin, _price_comparer);
-         LadderRender.render_piqs(_piq_vis_tup.visual, _last_vis_tup.glyph_context, origin_index, _price_list, _vm.price_vs_piq, _settings.row_height, security.ContractSpec, _settings.piq_column);
+         LadderRender.render_piqs(_piq_vis_tup.visual, _last_vis_tup.glyph_context, origin_index, _price_list, _vm.price_vs_piq, _settings.row_height, security.ContractSpec, _settings.piq_column, _fmt_mkt_quantity);
       }
 
       void _refresh_sizes() {
          Log.assert_d(_price_list != null);
          int origin_index = LadderRender.index_of(_price_list, _mkt_break_lines.origin, _price_comparer);
-         LadderRender.render_sizes(_bid_vis_tup.visual, _bid_vis_tup.glyph_context, origin_index, _price_list, _bids, _settings.row_height, security.ContractSpec, _settings.bid_column, _fmt_size);
-         LadderRender.render_sizes(_ask_vis_tup.visual, _ask_vis_tup.glyph_context, origin_index, _price_list, _asks, _settings.row_height, security.ContractSpec, _settings.ask_column, _fmt_size);
+         LadderRender.render_sizes(_bid_vis_tup.visual, _bid_vis_tup.glyph_context, origin_index, _price_list, _bids, _settings.row_height, security.ContractSpec, _settings.bid_column, _fmt_mkt_depth_item);
+         LadderRender.render_sizes(_ask_vis_tup.visual, _ask_vis_tup.glyph_context, origin_index, _price_list, _asks, _settings.row_height, security.ContractSpec, _settings.ask_column, _fmt_mkt_depth_item);
       }
 
       /// <summary>
@@ -898,7 +943,17 @@ namespace mbts.spark {
          if (vapls != null) {
             Log.assert_d(_price_list != null);
             var last_index = LadderRender.index_of(_price_list, _last_trade.price, _price_comparer);
-            LadderRender.render_volumes(_volume_vis_tup.visual, _volume_vis_tup.glyph_context, _price_list, vapls, _settings.row_height, security.ContractSpec, _settings.volume_column, last_index, _get_last_arrow_string());
+            LadderRender.render_volumes(
+               _volume_vis_tup.visual,
+               _volume_vis_tup.glyph_context,
+               _price_list,
+               vapls,
+               _settings.row_height,
+               security.ContractSpec,
+               _settings.volume_column,
+               last_index,
+               _get_last_arrow_string(),
+               _fmt_mkt_quantity);
             _old_last_trade = _last_trade;
          }
 
@@ -921,7 +976,7 @@ namespace mbts.spark {
             } 
             // regardless of if we've arrived here via a new Last (and new direction arrow)
             // or we're reusing the old one, this format bit is the same
-            return $"{_direction_arrow} {_last_trade.size} ";
+            return $"{_direction_arrow} {_fmt_mkt_quantity(_last_trade.size)} ";
          }
       }
 
@@ -1026,7 +1081,7 @@ namespace mbts.spark {
          double best_bid = _get_top_price(_bids);
          double best_ask = _get_top_price(_asks);
          return double.IsNaN(best_bid) ?
-            double.IsNaN(best_ask) ? _vm.low : security.ContractSpec.tickdown(best_ask) :
+            double.IsNaN(best_ask) ? _vm.settlement : security.ContractSpec.tickdown(best_ask) :
             best_bid;
       }
 
@@ -1034,7 +1089,7 @@ namespace mbts.spark {
          double best_bid = _get_top_price(_bids);
          double best_ask = _get_top_price(_asks);
          return double.IsNaN(best_ask) ?
-            double.IsNaN(best_bid) ? security.ContractSpec.tickdown(_vm.high) : best_bid :
+            double.IsNaN(best_bid) ? _vm.settlement : best_bid :
             security.ContractSpec.tickdown(best_ask);
       }
 
@@ -1042,7 +1097,7 @@ namespace mbts.spark {
          double best_bid = _get_top_price(_bids);
          double best_ask = _get_top_price(_asks);
          return double.IsNaN(best_bid) ?
-            double.IsNaN(best_ask) ? 0.5 * (_vm.low + _vm.high) : security.ContractSpec.tickdown(best_ask) :
+            double.IsNaN(best_ask) ? _vm.settlement : security.ContractSpec.tickdown(best_ask) :
             double.IsNaN(best_ask) ? best_bid : TickUtils.mid_tick(security.ContractSpec, best_bid, best_ask);
       }
 
@@ -1079,7 +1134,9 @@ namespace mbts.spark {
          GlyphContext glyph_context(LadderColumnSettings cs) =>
             GlyphContext.create(cs.font_family, cs.font_weight);
 
-         _fmt_size = MDDisplayHelper.get_formatter_nps(_settings.size_display);
+         var mkt_qty_display_divisor = _vm?.display_quantity_divisor ?? 1;
+         _fmt_mkt_depth_item_impl = MDDisplayHelper.get_formatter_nps(_settings.size_display, mkt_qty_display_divisor);
+         _fmt_mkt_quantity_impl = MDDisplayHelper.get_value_formatter(mkt_qty_display_divisor);
          _set_columns();
          _apply_column_visual_offset();
          if (prev_row_height != _settings.row_height)
@@ -1128,6 +1185,22 @@ namespace mbts.spark {
          }
          visible_columns_changed?.Invoke();
       }
+
+      // This is designed to be a redundant null check for _fmt_mkt_depth_item_impl.
+      string _fmt_mkt_depth_item(NativePriceSize value) {
+         // Assign the impl delegate to a local variable, just in case it is reassigned on another thread.
+         // This shouldn't happen, but better to avoid the potential null ref just in case it does. Expect the unexpected.
+         var impl = _fmt_mkt_depth_item_impl;
+         return impl is null ? MDDisplayHelper.get_formatter_nps(MarketSizeDisplay.get_default())?.ToString() ?? "Error" : impl(value);
+      }
+
+      // This is designed to be a redundant null check for _fmt_mkt_quantity_impl.
+      string _fmt_mkt_quantity(uint value) {
+         // Assign the impl delegate to a local variable, just in case it is reassigned on another thread.
+         // This shouldn't happen, but better to avoid the potential null ref just in case it does. Expect the unexpected.
+         var impl = _fmt_mkt_quantity_impl;
+         return impl is null ? value.ToString() : impl(value);
+      }
  
       void _init_tactile_adorner() {
          Disposable.dispose(ref _tactile_adorner);

src/client/spark/Modules/Trading/Ladder/View/LadderRender.cs

@@ -12,20 +12,24 @@ using System.Linq;
 using System.Threading.Tasks;
 using System.Windows;
 using System.Windows.Media;
+using bts.utils;
 
 namespace mbts.spark {
    static class BadgeRender {
       // IMPORTANT: the return values for this method MUST BE IN SYNC with the "format" method, else "measure_height" and "LadderRender.measure_row_height" will be broken.
       static int _line_count_for_style(LadderSettings.BadgeStyle badge_style) => badge_style == LadderSettings.BadgeStyle.Alternate ? 2 : 1;
       // IMPORTANT: at the risk of being redundant, see above comment.
-      public static IReadOnlyList<string> format(Side side, uint quantity, uint filled, LadderSettings.BadgeStyle style) {
+      public static IReadOnlyList<string> format(Side side, uint quantity, uint filled, LadderSettings.BadgeStyle style, Func<uint, string> fmt_value = null) {
+         if (fmt_value is null)
+            fmt_value = FormattingDelegates.default_string<uint>();
          switch (style) {
             case LadderSettings.BadgeStyle.Alternate:
+               var working_qty = quantity > filled ? quantity - filled : 0;
                return new[] {
-                  $"{side.abbreviate()}:{filled}",
-                  $"W:{quantity - filled}"
+                  $"{side.abbreviate()}:{fmt_value(filled)}",
+                  $"W:{fmt_value(working_qty)}"
                };
-            default: return new[] { $"{filled}/{quantity}" };
+            default: return new[] { $"{fmt_value(filled)}/{fmt_value(quantity)}" };
          }
       }
 
@@ -193,16 +197,17 @@ namespace mbts.spark {
       }
 
       public static void render_volumes(
-        DrawingVisual dv,
-        GlyphContext glyph_context,
-        double[] prices,
-        IEnumerable<VolumeAtPriceLevelImmutable> data,
-        double row_height,
-        ContractSpecificationImmutable spec,
-        VolumeColumnSettings settings,
-        int last_index,
-        string last_size_and_direction
-        ) {
+         DrawingVisual dv,
+         GlyphContext glyph_context,
+         double[] prices,
+         IEnumerable<VolumeAtPriceLevelImmutable> data,
+         double row_height,
+         ContractSpecificationImmutable spec,
+         VolumeColumnSettings settings,
+         int last_index,
+         string last_size_and_direction,
+         Func<uint, string> fmt_value) {
+         //
          if (!data.Any()) {
             _clear_visual(dv);
             return;
@@ -224,6 +229,8 @@ namespace mbts.spark {
             _clear_visual(dv);
             return;
          }
+         if (fmt_value is null)
+            fmt_value = FormattingDelegates.default_string<uint>();
          // inflate the max so that the graph never fills the available space
          double max = data.Max(v => v.Volume) * 1.1;
          _render_cells(dv, row_height, data.Select(d => (d.Price, d)), settings.general, prices, spec, render_cell);
@@ -255,11 +262,11 @@ namespace mbts.spark {
                }
                x_bar += width;
                if (show_numbers)
-                  numbers_text.Add(v.ToString());
+                  numbers_text.Add(fmt_value(v));
             }
 
             if (settings.total.show_numbers) {
-               numbers_text.Add(vap.Volume.ToString());
+               numbers_text.Add(fmt_value(vap.Volume));
             }
             if (settings.show_ltq && last_trade_here) {
                numbers_text.Clear();
@@ -309,19 +316,33 @@ namespace mbts.spark {
          }
       }
 
-      internal static void render_last(DrawingVisual dv, GlyphContext glyph_context, NativePriceSize last, int index, double row_height, LadderColumnSettings settings) {
+      internal static void render_last(DrawingVisual dv, GlyphContext glyph_context, NativePriceSize last, int index, double row_height, LadderColumnSettings settings, Func<uint, string> fmt_value) {
+         if (fmt_value is null)
+            fmt_value = FormattingDelegates.default_string<uint>();
          using (var dc = dv.RenderOpen()) {
-            var gr = format_text(last.size.ToString(), index, row_height, settings, glyph_context);
+            var gr = format_text(fmt_value(last.size), index, row_height, settings, glyph_context);
             dc.DrawGlyphRun(settings.foreground.rgb_brush(), gr);
          }
       }
 
       // this is basically a copy of redner_sizes up above
-      internal static void render_piqs(DrawingVisual dv, GlyphContext glyph_context, int origin_index, double[] prices, IEnumerable<(double price, uint piq)> pvp, double row_height, ContractSpecificationImmutable spec, LadderColumnSettings settings) {
+      internal static void render_piqs(
+         DrawingVisual dv,
+         GlyphContext glyph_context,
+         int origin_index,
+         double[] prices,
+         IEnumerable<(double price, uint piq)> pvp,
+         double row_height,
+         ContractSpecificationImmutable spec,
+         LadderColumnSettings settings,
+         Func<uint, string> fmt_value) {
+         //
          using (var dc = dv.RenderOpen()) {
             using (_draw_with_clip(dc, settings, row_height, prices.Length)) {
                if (!prices.within_range(origin_index) || pvp.is_null_or_empty())
                   return;
+               if (fmt_value is null)
+                  fmt_value = FormattingDelegates.default_string<uint>();
                var foreground = settings.foreground.rgb_brush();
                int curr_index = origin_index;
                double curr_price = prices[curr_index];
@@ -332,7 +353,7 @@ namespace mbts.spark {
                   curr_index += tick_diff;
                   curr_price = price;
                   if (curr_index >= 0 && curr_index < prices.Length) {
-                     var gr = format_text(entry.piq.ToString(), curr_index, row_height, settings, glyph_context);
+                     var gr = format_text(fmt_value(entry.piq), curr_index, row_height, settings, glyph_context);
                      dc.DrawGlyphRun(foreground, gr);
                   } else break;
                }
@@ -371,4 +392,4 @@ namespace mbts.spark {
          using (dv.RenderOpen()) { }
       }
    }
-}
+}

src/client/spark/Modules/Trading/Ladder/View/LadderSettingsView.xaml

@@ -1019,45 +1019,47 @@
       <Grid HorizontalAlignment="Left" Margin="6">
         <Grid.RowDefinitions>
           <RowDefinition Height="Auto"/>
+          <RowDefinition Height="{Binding Source={StaticResource VerticalPush1}}"/>
           <RowDefinition Height="Auto" />
           <RowDefinition Height="{Binding Source={StaticResource VerticalPush1}}"/>
-          <RowDefinition Height="Auto"/>
+          <RowDefinition Height="*"/>
         </Grid.RowDefinitions>
         <Grid.ColumnDefinitions>
           <ColumnDefinition Width="Auto"/>
-          <ColumnDefinition Width="Auto"/>
-          <ColumnDefinition Width="50"/>
           <ColumnDefinition Width="{Binding Source={StaticResource HorizontalPush3}}"/>
           <ColumnDefinition Width="*"/>
         </Grid.ColumnDefinitions>
         <!-- market cross -->
-        <CheckBox Name="warn" Grid.Column="0" FlowDirection="RightToLeft" IsChecked="{Binding show_warn_on_cross}">
-          <CheckBox.Resources>
-            <Style TargetType="{x:Type Path}">
-              <Setter Property="FlowDirection" Value="LeftToRight"/>
-            </Style>
-          </CheckBox.Resources>
+        <CheckBox Grid.Column="0" VerticalContentAlignment="Center" IsChecked="{Binding show_warn_on_cross}">
+          <TextBlock
+            Style="{StaticResource EnableDisableFeatureText}"
+            IsEnabled="{Binding show_warn_on_cross}"
+            Text="Warn on Market Cross"
+          />
         </CheckBox>
-        <TextBlock Grid.Column="1"
-                   Style="{StaticResource EnableDisableFeatureText}"
-                   IsEnabled="{Binding ElementName=warn, Path=IsChecked}"
-                   Text="Warn on Market Cross" />
         <!-- max order qty -->
-        <CheckBox Name="enforce_max_clip" Grid.Row="1" Grid.Column="0" FlowDirection="RightToLeft" IsChecked="{Binding enforce_max_clip}">
-          <CheckBox.Resources>
-            <Style TargetType="{x:Type Path}">
-              <Setter Property="FlowDirection" Value="LeftToRight"/>
-            </Style>
-          </CheckBox.Resources>
+        <CheckBox Grid.Row="2" Grid.Column="0" VerticalContentAlignment="Center" IsChecked="{Binding enforce_max_clip}">
+          <TextBlock
+            Style="{StaticResource EnableDisableFeatureText}"
+            IsEnabled="{Binding enforce_max_clip}"
+            Text="Max Order Quantity"
+          />
         </CheckBox>
-        <TextBlock Grid.Row="1" Grid.Column="1"
-                   Style="{StaticResource EnableDisableFeatureText}"
-                   IsEnabled="{Binding ElementName=enforce_max_clip, Path=IsChecked}"
-                   MinWidth="{Binding ElementName=warn, Path=ActualWidth}"
-                   Text="Max Order Quantity"/>
-        <c:TickUpDownUInt Grid.Row="1" Grid.Column="2"
-                          IsEnabled="{Binding ElementName=enforce_max_clip, Path=IsChecked}"
-                          Value="{Binding max_clip}" />
+        <c:TickUpDownUInt
+          Grid.Row="2"
+          Grid.Column="2"
+          IsEnabled="{Binding enforce_max_clip}"
+          Value="{Binding max_clip}"
+          Width="60"
+        />
+        <CheckBox Grid.Row="4" VerticalContentAlignment="Center" IsChecked="{Binding enforce_max_settlement_cross_ticks}">
+          <TextBlock
+            Style="{StaticResource EnableDisableFeatureText}"
+            IsEnabled="{Binding enforce_max_settlement_cross_ticks}"
+            Text="Max Ticks from Settlement"
+          />
+        </CheckBox>
+        <c:TickUpDownInt Grid.Row="4" Grid.Column="2" IsEnabled="{Binding enforce_max_settlement_cross_ticks}" Value="{Binding max_settlement_cross_ticks}"/>
       </Grid>
     </TabItem>
     <TabItem Header="Mini Order Book">

src/client/spark/Modules/Trading/Ladder/View/LadderView.xaml

@@ -426,9 +426,26 @@
                      Text="{Binding left_panel_width, Converter={StaticResource VolumeTextConverter}}"
                      Margin="0,0,0,4"
                      Visibility="{Binding show_volume, Converter={StaticResource BooleanToVisibilityConverter}}"/>
-              <TextBlock Grid.Column="2" Grid.Row="5" Text="{Binding volume, Mode=OneWay}" FontWeight="Bold"
-                     Margin="0,0,0,4"
-                     Visibility="{Binding show_volume, Converter={StaticResource BooleanToVisibilityConverter}}"/>
+              <TextBlock
+                Grid.Column="2"
+                Grid.Row="5"
+                FontWeight="Bold"
+                Margin="0,0,0,4"
+                Visibility="{Binding show_volume, Converter={StaticResource BooleanToVisibilityConverter}}"
+              >
+                <TextBlock.Text>
+                  <MultiBinding>
+                    <MultiBinding.Converter>
+                      <converters:MultiValueConverterPipe>
+                        <x:Static MemberType="{x:Type converters:DynamicDoubleDivisorConverter}" Member="Instance"/>
+                        <x:Static MemberType="{x:Type converters:ValueConverters}" Member="SimpleString"/>
+                      </converters:MultiValueConverterPipe>
+                    </MultiBinding.Converter>
+                    <Binding Path="volume" Mode="OneWay"/>
+                    <Binding Path="display_quantity_divisor" Mode="OneTime"/>
+                  </MultiBinding>
+                </TextBlock.Text>
+              </TextBlock>
             </Grid>
             <!-- Account combobox -->
             <ComboBox DataContext="{Binding order_properties_vm}" Margin="2,10,2,2" 
@@ -507,7 +524,7 @@
               mbts:TextBoxBehavior.IncrementDecrementOnMouseClick="True"
               HorizontalContentAlignment="Right"
               Margin="2"
-              Text="{Binding size_calculator.value, Mode=TwoWay, UpdateSourceTrigger=PropertyChanged}"
+              Text="{Binding size_calculator.display_value, Mode=TwoWay, UpdateSourceTrigger=PropertyChanged}"
               ContextMenu="{x:Null}"
             />
             <!-- Qty quick buttons -->
@@ -522,7 +539,14 @@
               </ItemsControl.ItemsPanel>
               <ItemsControl.ItemTemplate>
                 <DataTemplate>
-                  <Button Margin="2" Command="{Binding Path=DataContext.size_calculator.click, RelativeSource={RelativeSource AncestorType=ItemsControl}}" CommandParameter="{Binding}" Content="{Binding}" Focusable="False"/>
+                  <Button Margin="2" Command="{Binding Path=DataContext.size_calculator.click, RelativeSource={RelativeSource AncestorType=ItemsControl}}" Content="{Binding}" Focusable="False">
+                    <Button.CommandParameter>
+                      <MultiBinding Converter="{x:Static converters:DynamicDoubleMultiplierConverter.Instance}">
+                        <Binding/>
+                        <Binding Path="DataContext.display_quantity_divisor" RelativeSource="{RelativeSource AncestorType=spark:LadderView}"/>
+                      </MultiBinding>
+                    </Button.CommandParameter>
+                  </Button>
                 </DataTemplate>
               </ItemsControl.ItemTemplate>
             </ItemsControl>

src/client/spark/Modules/Trading/Ladder/View/LadderView.xaml.cs

@@ -93,6 +93,7 @@ namespace mbts.spark {
          _ui_scaler.MouseDoubleClick += _ui_scaler_MouseDoubleClick;
          this.PreviewMouseWheel += LadderView_PreviewMouseWheel;
          this.PreviewMouseDown += LadderView_PreviewMouseDown;
+         PreviewKeyDown += (s, e) => vm.key_down(e);
       }
 
       IDisposable _connect_left_panel_scroll() {

src/client/spark/Modules/Trading/ManualFills/ManualFillRow.cs

@@ -3,6 +3,7 @@ using bts.api.position;
 using bts.utils;
 using mbts;
 using mbts.spark;
+using mbts.ui;
 using mbts.ui.shell;
 using System;
 using System.Collections.Generic;
@@ -25,24 +26,27 @@ namespace bts.shell.manual_fills {
       readonly Property<bool> _is_dirty;
       readonly Property<EditableItemState> _editable_item_state;
       readonly DelegateProperty<bool> _is_valid;
+      readonly DisplayQuantityMultiplier _size = new DisplayQuantityMultiplier();
+      readonly Func<SecurityImmutable?, uint> _get_display_qty_divisor;
       SecurityImmutable? _security;
       AccountTuple? _account;
       UserTuple? _user;
       Side _side;
-      uint _size;
       double _price;
       bool _is_selected;
       ManualFillData? _data;
       IDisposable _committed_snapshot;
 
-      public ManualFillRow(ManualFillData data) {
+      public ManualFillRow(ManualFillData data, Func<SecurityImmutable?, uint> get_display_qty_divisor) {
          _data = data;
+         _get_display_qty_divisor = get_display_qty_divisor ?? new Func<SecurityImmutable?, uint>(sec => 1);
          key = data.key;
          _security = data.value.security;
          _account = data.value.account;
          _user = data.value.user;
          _side = data.value.manual_fill.Side;
-         _size = data.value.manual_fill.Quantity;
+         _size.actual_value = data.value.manual_fill.Quantity;
+         _size.conversion_data = new QuantityConversionData(_get_display_qty_divisor(data.value.security), QuantityConversionData.OpType.DivideActual);
          _price = data.value.manual_fill.Price;
          if (placeholder_key.HasValue) {
             _is_dirty = backing(nameof(is_dirty), false);
@@ -53,6 +57,7 @@ namespace bts.shell.manual_fills {
             _editable_item_state = backing(nameof(editable_item_state), _is_dirty, ch => ch.newval ? EditableItemState.Modified : EditableItemState.None);
          }
          _is_valid = backing(nameof(is_valid), () => _validate(this));
+         _dispose = _size.connect_owner(this, nameof(size), nameof(display_size));
       }
 
       public event Action<bool> is_selected_changed;
@@ -65,8 +70,10 @@ namespace bts.shell.manual_fills {
       public SecurityImmutable? security {
          get => _security;
          set {
-            if (_set(ref _security, value))
+            if (_set(ref _security, value)) {
+               _size.conversion_data = new QuantityConversionData(_get_display_qty_divisor(value), QuantityConversionData.OpType.DivideActual);
                RaisePropertyChanged(nameof(spec));
+            }
          }
       }
       public ContractSpecificationImmutable? spec => security.spec_or_default();
@@ -75,7 +82,8 @@ namespace bts.shell.manual_fills {
       public UserTuple? user { get => _user; set => _set(ref _user, value); }
       // side/size/price
       public Side side { get => _side; set => _set(ref _side, value); }
-      public uint size { get => _size; set => _set(ref _size, value); }
+      public uint size { get => _size.actual_value; set => _size.actual_value = value; }
+      public uint display_size { get => _size.display_value; set => _size.display_value = value; }
       public double price { get => _price; set => _set(ref _price, value); }
       // is selected
       public bool is_selected {

src/client/spark/Modules/Trading/ManualFills/ManualFillRowEditor.xaml

@@ -71,7 +71,7 @@
       <ComboBox Grid.Row="2" Grid.Column="2" ItemsSource="{DynamicResource ResourceKey={x:Static u:ResourceKeys.Accounts}}" SelectedItem="{Binding account}"/>
       <ComboBox Grid.Row="2" Grid.Column="4" ItemsSource="{DynamicResource ResourceKey={x:Static u:ResourceKeys.Users}}" SelectedItem="{Binding user}"/>
       <ComboBox Grid.Row="2" Grid.Column="6" ItemsSource="{DynamicResource ResourceKey={x:Static u:ResourceKeys.Sides}}" SelectedItem="{Binding side}" Width="48"/>
-      <c:TickUpDownUInt Grid.Row="2" Grid.Column="8" MinWidth="40" Value="{Binding size}"/>
+      <c:TickUpDownUInt Grid.Row="2" Grid.Column="8" MinWidth="40" Value="{Binding display_size}"/>
       <usp:PriceEntryControl Grid.Row="2" Grid.Column="10" MinWidth="55" Value="{Binding price}" ContractSpec="{Binding spec}"/>
     </Grid>
     <c:DialogSkirt Grid.Row="1" Margin="0,6,0,0">

src/client/spark/Modules/Trading/ManualFills/ManualFillsModel.cs

@@ -1,4 +1,5 @@
-using bts.api.core;
+using bts.api;
+using bts.api.core;
 using bts.api.position;
 using bts.collections;
 using mbts.spark;
@@ -103,5 +104,8 @@ namespace bts.shell.manual_fills {
 
       public async Task<bool> update_fills(IEnumerable<ManualFill> fills) =>
          await _model.update_manual_fills(fills);
+
+      public uint get_display_qty_divisor(SecurityImmutable? security) =>
+         _model.security_auxiliary_model.get_display_quantity_divisor(security);
    }
 }

src/client/spark/Modules/Trading/ManualFills/ManualFillsVM.cs

@@ -2,6 +2,7 @@ using bts.api;
 using bts.api.core;
 using bts.api.position;
 using bts.collections;
+using bts.utils;
 using mbts;
 using mbts.spark;
 using mbts.ui;
@@ -67,7 +68,7 @@ namespace bts.shell.manual_fills {
             RXCollection.connect(_persisted_rows,
                _model.manual_fills.OnDispatcher(),
                Observable.Return(Comparer<ManualFillData>.Create((a, b) => a.key.CompareTo(b.key))),
-               mfd => new ManualFillRow(mfd),
+               mfd => new ManualFillRow(mfd, model.get_display_qty_divisor),
                mfr => mfr.data),
             _bus.subscribe(SparkTags.SecuritiesTag).OnDispatcher().Subscribe(m => {
                security_map = new FilteredDictionary<uint, SecurityMD>(m, smd => smd.security.ContractCase == Security.ContractOneofCase.Future);
@@ -125,7 +126,8 @@ namespace bts.shell.manual_fills {
                new ManualFillKey(_placeholder_id_counter++),
                new ManualFillTuple(new ManualFillImmutable(new ManualFill {
                   Side = Side.Buy
-               }), null, accounts.FirstOrDefault(), users.FirstOrDefault())));
+               }), null, accounts.FirstOrDefault(), users.FirstOrDefault())),
+            _model.get_display_qty_divisor);
 
       void _add_fill(ManualFillRow new_row) =>
          _placeholder_rows.InsertSorted((new_row ?? (new_row = row_factory())).placeholder_key.HasValue ?
@@ -209,11 +211,20 @@ namespace bts.shell.manual_fills {
             } else {
                add_imported_fills();
             }
-            void add_imported_fills() =>
-               _placeholder_rows.InsertSorted(parsed_fills.Select(pmf => new ManualFillRow(new ManualFillData(new ManualFillKey(_placeholder_id_counter++), new ManualFillTuple(new ManualFillImmutable(pmf.result),
-                  pmf.result.SecurityKey != 0 && security_map.TryGetValue(pmf.result.SecurityKey, out var smd) ? smd.security : (SecurityImmutable?)null,
-                  accounts.FirstOrDefault(a => a?.id == pmf.result.AccountId),
-                  users.FirstOrDefault(a => a?.id == pmf.result.UserId))))), _row_key_comparer);
+            void add_imported_fills() {
+               _placeholder_rows.InsertSorted(parsed_fills.Select(mk_row), _row_key_comparer);
+
+               ManualFillRow mk_row(ParsedManualFill pmf) {
+                  var data = new ManualFillData(
+                     new ManualFillKey(_placeholder_id_counter++),
+                     new ManualFillTuple(
+                        new ManualFillImmutable(pmf.result),
+                        pmf.result.SecurityKey != 0 && security_map.TryGetValue(pmf.result.SecurityKey, out var smd) ? smd.security : (SecurityImmutable?)null,
+                        accounts.FirstOrDefault(a => a?.id == pmf.result.AccountId),
+                        users.FirstOrDefault(a => a?.id == pmf.result.UserId)));
+                  return new ManualFillRow(data, _model.get_display_qty_divisor);
+               }
+            }
          } catch (Exception ex) {
             BTSMessageBox.Error($"Error importing fills: {ex}.", ManualFillsWindowFactory.window_name);
          }

src/client/spark/Modules/Trading/ManualFills/ManualFillsView.xaml

@@ -212,12 +212,12 @@
           <DataGridTemplateColumn c:DataGridEx.CellKey="{x:Static Size, MemberType={u:Nested usp:ManualFillsView.Columns}}" Header="Qty" SortMemberPath="side">
             <DataGridTemplateColumn.CellTemplate>
               <DataTemplate>
-                <TextBlock Text="{Binding size}" VerticalAlignment="Center"/>
+                <TextBlock Text="{Binding display_size}" VerticalAlignment="Center"/>
               </DataTemplate>
             </DataGridTemplateColumn.CellTemplate>
             <DataGridTemplateColumn.CellEditingTemplate>
               <DataTemplate>
-                <c:TickUpDownUInt MinWidth="40" Value="{Binding size, UpdateSourceTrigger=PropertyChanged}"/>
+                <c:TickUpDownUInt MinWidth="40" Value="{Binding display_size, UpdateSourceTrigger=PropertyChanged}"/>
               </DataTemplate>
             </DataGridTemplateColumn.CellEditingTemplate>
           </DataGridTemplateColumn>

src/client/spark/Modules/Trading/OrderBook/OrderBookColumns.cs

@@ -597,19 +597,19 @@ namespace mbts.spark {
 
       public class SizeColumn : OrderbookColumnBase<UIntMinMaxState>, IRenderColumn<OrderBookRowVM> {
          public SizeColumn(IDataGridColumnPersistentFilter<OrderSecurityRootPair, UIntMinMaxState> filter)
-            : base(Columns.Size, "Qty", r => r.quantity.ToString(), DefaultColumnWidths.Size, filter, DataGridFilterKnownTemplates.UIntMinMax, _wrap_comparer(r => r.quantity)) { }
+            : base(Columns.Size, "Qty", r => r.display_quantity.ToString(), DefaultColumnWidths.Size, filter, DataGridFilterKnownTemplates.UIntMinMax, _wrap_comparer(r => r.quantity)) { }
 
          public void draw(OrderBookRowVM row, DrawingContext dc, ColumnGeometry position, double row_height) =>
-            CellRender.draw_text(dc, _get_glyph_context(row), font_size, row.quantity.ToString(), position, row_height,
+            CellRender.draw_text(dc, _get_glyph_context(row), font_size, row.display_quantity.ToString(), position, row_height,
                RenderUtils.get_side_brush(row), null, horizontal_alignment, VerticalAlignment.Center, DefaultCellPadding);
       }
 
       public class FilledColumn : OrderbookColumnBase<UIntMinMaxState>, IRenderColumn<OrderBookRowVM> {
          public FilledColumn(IDataGridColumnPersistentFilter<OrderSecurityRootPair, UIntMinMaxState> filter)
-            : base(Columns.Filled, "Filled Qty", r => r.filled_quantity.ToString(), DefaultColumnWidths.Size, filter, DataGridFilterKnownTemplates.UIntMinMax, _wrap_comparer(r => r.filled_quantity)) { }
+            : base(Columns.Filled, "Filled Qty", r => r.display_filled_quantity.ToString(), DefaultColumnWidths.Size, filter, DataGridFilterKnownTemplates.UIntMinMax, _wrap_comparer(r => r.filled_quantity)) { }
 
          public void draw(OrderBookRowVM row, DrawingContext dc, ColumnGeometry position, double row_height) =>
-            CellRender.draw_text(dc, _get_glyph_context(row), font_size, row.filled_quantity.ToString(), position, row_height,
+            CellRender.draw_text(dc, _get_glyph_context(row), font_size, row.display_filled_quantity.ToString(), position, row_height,
                RenderUtils.get_side_brush(row), null, horizontal_alignment, VerticalAlignment.Center, DefaultCellPadding);
       }
 
@@ -1163,7 +1163,7 @@ namespace mbts.spark {
 
          public override FrameworkElement view_factory() {
             var tick_up_down = new TickUpDownNullableUIntCommit();
-            tick_up_down.SetBinding(TickUpDownNullableUIntCommit.SourceValueProperty, nameof(OrderBookRowVM.prospective_quantity));
+            tick_up_down.SetBinding(TickUpDownNullableUIntCommit.SourceValueProperty, nameof(OrderBookRowVM.prospective_display_quantity));
             tick_up_down.SetBinding(TickUpDownNullableUIntCommit.OnCommitProperty, nameof(OrderBookRowVM.modify_order_quantity_andor_price));
             tick_up_down.InputBindings.Add(_create_keyinput_binding(Key.Enter, nameof(OrderBookRowVM.modify_order_quantity_andor_price)));
             tick_up_down.InputBindings.Add(_create_keyinput_binding(Key.Escape, nameof(OrderBookRowVM.revert_prospective_order_quantity_andor_price)));

src/client/spark/Modules/Trading/OrderBook/OrderBookRowVM.cs

@@ -29,16 +29,16 @@ namespace mbts.spark {
       int _depth_level;
       SecurityImmutable? _security => order_tuple.order.security;
       // for mini-ob 
-      uint _prospective_quantity;
+      DisplayQuantityMultiplier _prospective_qty_translator_backing;
+      uint _display_qty_divisor_backing;
+      bool _display_qty_divisor_dirty = true;
       double _prospective_price;
       Action<bool> _on_selection_changed;
 
       public OrderBookRowVM(OrderBookVM owner, OrderSecurityRootPair order_tuple, bool is_expanded, Action<bool> on_selection_changed) {
          _owner = owner;
          this.order_tuple = order_tuple;
-         is_visible = !is_child;
          _is_expanded = is_expanded;
-         prospective_quantity = this.quantity;
          prospective_price = this.price;
          _on_selection_changed = on_selection_changed;
       }
@@ -95,14 +95,18 @@ namespace mbts.spark {
       public string last_price_text => _fmt_price(last_price);
       public string avg_price_text => _fmt_price(avg_price);
       public uint quantity => order.quantity();
+      public uint display_quantity => quantity.safe_divide(_display_qty_divisor);
       public uint filled_quantity => order.filled();
+      public uint display_filled_quantity => filled_quantity.safe_divide(_display_qty_divisor);
       public string last_msg => order.last_msg();
+      // piq
       public uint piq => order_tuple.order.piq ?? uint.MaxValue;
-      public string piq_text => piq == uint.MaxValue ? string.Empty : piq.ToString();
+      public string piq_text => piq == uint.MaxValue ? string.Empty : piq.safe_divide(_display_qty_divisor).ToString();
+
       public bool is_non_terminal => order.is_non_terminal();
       public bool is_attachable { get => _is_attachable; set => SetVisual(ref _is_attachable, value); }
       public bool is_detachable { get => _is_detachable; set => SetVisual(ref _is_detachable, value); }
-      public string filled_status_desc => order.filled_status_description(security.spec_or_default());
+      public string filled_status_desc => order.filled_status_description(security.spec_or_default(), _display_qty_divisor);
 
       // Root Algo
       public CustomOrderDefinition.CustomOneofCase root_algo_order_type => order_tuple.root.algo.value.CustomCase;
@@ -113,7 +117,6 @@ namespace mbts.spark {
       // Tree
       public bool is_parent { get => _is_parent; set => Set(ref _is_parent, value); }
       public bool is_child => order.has_parent();
-      public bool is_visible { get; set; }
       public bool is_expanded {
          get => _is_expanded;
          set {
@@ -131,12 +134,12 @@ namespace mbts.spark {
          }
       }
       public uint prospective_quantity {
-         get => _prospective_quantity;
-         set {
-            if (Set(ref _prospective_quantity, value)) {
-               RaisePropertyChanged(nameof(is_qty_dirty));
-            }
-         }
+         get => _prospective_qty_translator.actual_value;
+         set => _prospective_qty_translator.actual_value = value;
+      }
+      public uint prospective_display_quantity {
+         get => _prospective_qty_translator.display_value;
+         set => _prospective_qty_translator.display_value = value;
       }
       public double prospective_price {
          get => _prospective_price;
@@ -226,6 +229,29 @@ namespace mbts.spark {
          }
       }
 
+      uint _display_qty_divisor {
+         get {
+            _sync_display_qty_if_dirty();
+            return _display_qty_divisor_backing;
+         }
+      }
+
+      IDisplayTranslator<uint> _prospective_qty_translator {
+         get {
+            if (_prospective_qty_translator_backing == null) {
+               _prospective_qty_translator_backing = new DisplayQuantityMultiplier {
+                  conversion_data = new QuantityConversionData(_display_qty_divisor, QuantityConversionData.OpType.DivideActual),
+                  actual_value = quantity
+               };
+               _prospective_qty_translator.value_changed += () =>
+                  RaisePropertyChanged(nameof(is_qty_dirty));
+            } else {
+               _sync_display_qty_if_dirty();
+            }
+            return _prospective_qty_translator_backing;
+         }
+      }
+
       #region IHierarchicalRow
       bool IHierarchicalRow.is_parent => is_parent;
       bool IHierarchicalRow.is_expanded => is_expanded;
@@ -269,22 +295,35 @@ namespace mbts.spark {
          if ((Columns.OrderType & dirty) != 0)
             RaisePropertyChanged(nameof(order_type), nameof(order_metadata));
          // quantity
-         if ((Columns.Size & dirty) != 0) {
-            RaisePropertyChanged(nameof(quantity), nameof(is_qty_dirty));
-            // we need to update the prospective_quantity here b/c an update could have come in while the row was in edit mode
-            // via the Mini OB update column mechanism (vs the EditableQty column)
-            // prospecive price does not need to be updated in the same manner b/c if the price is changed, the whole
-            // row will no longer match the filter
-            prospective_quantity = quantity;
-         }
          // price
          if ((Columns.Price & dirty) != 0) {
             RaisePropertyChanged(nameof(price));
             RaisePropertyChanged(nameof(is_price_dirty));
          }
          // security
-         if ((Columns.Security & dirty) != 0)
-            RaisePropertyChanged(nameof(security), nameof(security_text));
+         if ((Columns.Security & dirty) != 0) {
+            _display_qty_divisor_dirty = true;
+            RaisePropertyChanged(
+               // security props
+               nameof(security),
+               nameof(security_text),
+               // qty props
+               nameof(display_quantity),
+               nameof(prospective_quantity),
+               nameof(prospective_display_quantity),
+               nameof(is_qty_dirty),
+               //
+               nameof(piq_text),
+               nameof(display_filled_quantity));
+         }
+         if ((Columns.Size & dirty) != 0) {
+            RaisePropertyChanged(nameof(quantity), nameof(display_quantity));
+            if (_prospective_qty_translator_backing != null)
+               _prospective_qty_translator_backing.actual_value = quantity;
+         }
+         if ((Columns.Filled & dirty) != 0) {
+            RaisePropertyChanged(nameof(filled_quantity), nameof(display_filled_quantity));
+         }
          // badge fill
          if (old_order_tuple.order.meta?.badge_color != order_tuple.order.meta?.badge_color) {
             // invalidate by setting to null (will be re-instantiated in the public getter)
@@ -361,6 +400,15 @@ namespace mbts.spark {
          security.Value.ContractSpec.format(v) :
          Math.Round(v, _unknown_security_price_num_fractional_digits, MidpointRounding.AwayFromZero).ToString(_unknown_security_price_format_string);
 
+      void _sync_display_qty_if_dirty() {
+         if (_display_qty_divisor_dirty) {
+            _display_qty_divisor_dirty = false;
+            _display_qty_divisor_backing = _owner.get_display_qty_divisor(security);
+            if (_prospective_qty_translator_backing != null)
+               _prospective_qty_translator_backing.conversion_data = new QuantityConversionData(_display_qty_divisor_backing, QuantityConversionData.OpType.DivideActual);
+         }
+      }
+
       void RaisePropertyChanged(params string[] props) {
          var pc = PropertyChanged;
          if (pc == null)
@@ -399,6 +447,7 @@ namespace mbts.spark {
                Columns.LastMessage |
                Columns.Piq,
             filled_status_desc_mask =
+               Columns.Security |
                Columns.Filled |
                Columns.AvgFilled |
                Columns.Status;

src/client/spark/Modules/Trading/OrderBook/OrderBookVM.cs

@@ -51,6 +51,7 @@ namespace mbts.spark {
       readonly OrderParamsAggregator _selected_params_mon;
       readonly CommonValueMonitor<SecurityImmutable?> _selected_security_mon = new CommonValueMonitor<SecurityImmutable?>();
       readonly RightPanelModel _right_panel = new RightPanelModel();
+      readonly CustomStateSynchronizer _custom_state_sync;
       OrderBookFillsGridSettings _cached_fills_settings = OrderBookStartupData.DefaultFillsGrid;
       double
          _raw_right_panel_width = OrderBookStartupData.Default.right_panel_width,
@@ -124,6 +125,8 @@ namespace mbts.spark {
          _row_collection.CollectionChanged += _row_collection_CollectionChanged;
          _current_row = backing<OrderBookRowVM>(nameof(current_row));
          _columns.filter_changed += _on_filter_changed;
+         _custom_state_sync = new CustomStateSynchronizer(this);
+         // commands
          collapse_all_rows_command = new DelegateCommand(_row_collection.collapse_all);
          expand_all_rows_command = new DelegateCommand(_row_collection.expand_all);
          var modify_selected_orders_async_cmd = new AsyncCommand(_modify_selected_orders_async, () => _selected_params_mon.all_active && order_mod_vm.is_dirty);
@@ -188,6 +191,7 @@ namespace mbts.spark {
                security_plurality = p;
                RaisePropertyChanged(nameof(security_plurality));
             }),
+            _current_row.Subscribe(_ => _custom_state_sync.sync()),
             orders_source.OnDispatcher().Subscribe(t => {
                if (_selected_rows.Count == 0) {
                   _cached_orders = t.state;
@@ -207,6 +211,8 @@ namespace mbts.spark {
                      }
                   }
                }
+               _custom_state_sync.sync(true);
+               orders_changed?.Invoke();
             }),
             model.on_orders_can_attach.OnDispatcher().Subscribe(table => {
                _cached_attachable = new MappedDictionary<uint, KeyValuePair<uint, bool>, bool>(table.state, kv => kv.Value);
@@ -375,7 +381,7 @@ namespace mbts.spark {
       }
 
       public event Action<OrderRecordImmutable?> selected_order_changed;
-      public event Action begin_attaching, end_attaching;
+      public event Action begin_attaching, end_attaching, orders_changed;
       public event Action<(IEnumerable, bool)> request_selection;
 
       public ObservableAppendCollection<DIYGrid.ColumnBase> columns { get; }
@@ -395,6 +401,7 @@ namespace mbts.spark {
          }
       }
       public OrderRecordImmutable? current_order => current_row?.order;
+      public ObservableCollection<NamedValueVM> current_algo_custom_state { get; } = new ObservableCollection<NamedValueVM>();
       public AlgoDefinitionVM algo_vm => order_mod_vm.algo_vm;
       public OrderParamsVM order_mod_vm { get; }
       public FillsVMContainer fills_vm { get; } = new FillsVMContainer();
@@ -474,6 +481,28 @@ namespace mbts.spark {
       public IObservable<bool> subscribe_show_fills() => _show_fills.observe_current(true);
       public IObservable<bool> subscribe_show_ladder() => _show_ladder.observe_current(true);
       public IObservable<bool> subscribe_show_order_params() => _show_order_params.observe_current(true);
+      public IObservable<OrderSecurityAlgo?> subscribe_single_selected_order() =>
+         Observable.Create<OrderSecurityAlgo?>(o => {
+            OrderSecurityAlgo? last_fired = null;
+            orders_changed += notify;
+            _current_row.Changed += on_current_row_changed;
+            notify();
+            return Disposable.Create(dispose);
+            // local methods
+            void notify() {
+               var next = current_row == null ? (OrderSecurityAlgo?)null : current_row.order_tuple.order;
+               if (next != last_fired)
+                  o.OnNext(last_fired = next);
+            }
+
+            void on_current_row_changed(OrderBookRowVM oldval, OrderBookRowVM newval) =>
+               notify();
+
+            void dispose() {
+               orders_changed -= notify;
+               _current_row.Changed -= on_current_row_changed;
+            }
+         });
 
       public void row_selection_changed(SelectionChangedEventArgs e) {
          try {
@@ -503,6 +532,7 @@ namespace mbts.spark {
             _can_attach_selected_orders.refresh();
             _can_detach_selected_orders.refresh();
             selected_order_changed?.Invoke(current_order);
+            _custom_state_sync.sync();
          } catch (Exception ex) {
             // [John]I observed a strange null-reference exception in this callback when the launcher was shutting down (see https://bluetradesys.atlassian.net/browse/SPARK-2089)
             Log.Ui.error($"[{nameof(OrderBookVM)}] Error handling selection change: {ex}");
@@ -609,6 +639,9 @@ namespace mbts.spark {
 
       public OrderMetadata get_metadata(OrderBookRowVM row) => _model.factory.get_metadata(row.order.actual_order_type());
 
+      internal uint get_display_qty_divisor(SecurityImmutable? security) =>
+         _model.security_auxiliary_model.get_display_quantity_divisor(security);
+
       internal void show_order_modify(OrderBookRowVM row) =>
          _bus.post(SparkTags.ShowModifyOrderTag, row.order_key);
 
@@ -723,13 +756,52 @@ namespace mbts.spark {
          }
       }
 
+      class CustomStateSynchronizer {
+         readonly OrderBookVM _vm;
+         OrderBookRowVM _synced_row;
+
+         public CustomStateSynchronizer(OrderBookVM vm) =>
+            _vm = vm;
+
+         public void sync(bool force_refresh = false) {
+            var row = _vm.current_row != null &&
+               _vm.selected_rows.Select(r => r.order_tuple.root.order.Key).Distinct().TryGetSingle(out uint droot) &&
+               _vm.current_row.order_tuple.root.order.Key == droot ?
+                  _vm.current_row : null;
+            if (force_refresh || row != _synced_row) {
+               _synced_row = row;
+               _refresh();
+            }
+         }
+
+         void _refresh() {
+            _vm.current_algo_custom_state.Clear();
+            if (_synced_row == null)
+               return;
+            var dcs = _synced_row.order.dynamic_custom_state();
+            // while dcs is not expected to be null, best to play it safe and double check.
+            if (dcs.is_null_or_empty()) {
+               var descendent_rows = _vm._row_collection.get_descendent_rows(_synced_row.order_key);
+               if (_vm._row_collection.filter != null)
+                  descendent_rows = descendent_rows.Where(child => _vm._row_collection.filter(child.order_tuple));
+               foreach (var dr in descendent_rows) {
+                  dcs = dr.order.dynamic_custom_state();
+                  if (!dcs.is_null_or_empty())
+                     break;
+               }
+            }
+            foreach (var p in dcs.empty_if_null().OrderBy(kv => kv.Key))
+               _vm.current_algo_custom_state.Add(new NamedValueVM(p.Key, DynamicOrderHelper.fmt_param(p.Value)));
+         }
+      }
+
       public class OrderParamsVM : DisposableViewModelBase {
          readonly SelectorProperty<AccountTuple, AccountTuple?> _accounts;
          readonly OrderBookVM _owner;
          readonly Property<bool> _is_dirty;
          IRaiseCanExecuteChangedCommand _payup_bid_cmd, _payup_ask_cmd;
          IAlgoParamVM<double> _price_param;
-         IAlgoParamVM<uint?> _size_param;
+         AlgoParamVM<uint?> _size_param;
          AlgoParamPermissions
             _price_permissions = AlgoParamPermissions.ReadOnly | AlgoParamPermissions.Write,
             _size_permissions = AlgoParamPermissions.ReadOnly | AlgoParamPermissions.Write;
@@ -766,7 +838,9 @@ namespace mbts.spark {
                      _price_param = null;
                      _size_param = null;
                   } else {
-                     _size_param = new AlgoParamVM<uint?>("size", "Size", owner._selected_params_mon.size) {
+                     _size_param = new AlgoParamVM<uint?>("size", "Size", owner._selected_params_mon.size, EqualityComparer<uint?>.Default,
+                        to_display_value: v => v.HasValue ? v.Value / display_quantity_divisor : v,
+                        from_display_value: v => v.HasValue ? v.Value * display_quantity_divisor : v) {
                         permissions = _size_permissions & _param_permissions
                      };
                      var price_param = new AlgoParamVM<double>("price", "Price", owner._selected_params_mon.price, spec?.tick_equality_comparer() ?? MathUtils.epsilon_eq_comparer) {
@@ -809,10 +883,11 @@ namespace mbts.spark {
             get => _security_md;
             set {
                if (Set(ref _security_md, value)) {
-                  RaisePropertyChanged(nameof(security), nameof(spec));
+                  RaisePropertyChanged(nameof(security), nameof(spec), nameof(display_quantity_divisor));
                   bbo.security_md = value;
                   _payup_bid_cmd.RaiseCanExecuteChanged();
                   _payup_ask_cmd.RaiseCanExecuteChanged();
+                  _size_param?.refresh_display_value();
                }
             }
          }
@@ -834,6 +909,7 @@ namespace mbts.spark {
          public AlgoDefinitionVM algo_vm { get; }
          public IReadOnlyObservableCollection<AlgoParamRowVM> param_rows { get; }
          public BBOVM bbo { get; }
+         public uint display_quantity_divisor => _owner.get_display_qty_divisor(security);
          public ICommand send_order { get; }
          public ICommand payup_bid_cmd => _payup_bid_cmd;
          public ICommand payup_ask_cmd => _payup_ask_cmd;

src/client/spark/Modules/Trading/OrderBook/OrderBookWindow.cs

@@ -1,4 +1,5 @@
-using bts.api;
+using bts;
+using bts.api;
 using bts.api.orderman;
 using bts.shell;
 using bts.shell.fills;
@@ -6,9 +7,11 @@ using bts.shell.orderbook;
 using bts.spark;
 using bts.view;
 using mbts.persist;
+using mbts.spark.utilities;
 using mbts.ui;
 using mbts.ui.extensions;
 using mbts.ui.spark;
+using mbts.ui.utilities;
 using mbts.ui.utility;
 using mbts.utils;
 using System;
@@ -24,7 +27,10 @@ namespace mbts.spark {
       const string _window_type = "OrderBook", _default_title = "Order Book";
       readonly INotificationService _notification_service;
       readonly IWindowSettingsManager<OrderBookGridSettings> _settings_manager;
+      readonly bool _can_edit_specific_algo_params;
       IDisposable _attachment_exit_sub;
+      // initialized in thread_init
+      List<IDisposable> _thread_init_resources;
       OrderBookStartupData _state;
       OrdersModel _model;
       OrderBookVM _vm;
@@ -34,13 +40,14 @@ namespace mbts.spark {
       SparkCommand[] _commands;
 
       public OrderBookWindow(OrdersModel model, OrderBookWindowFactory factory, IBus bus, INotificationService notification_service,
-         OrderBookStartupData state, ImageSource icon, IWindowSettingsManager<OrderBookGridSettings> settings_manager)
+         OrderBookStartupData state, ImageSource icon, IWindowSettingsManager<OrderBookGridSettings> settings_manager, bool can_edit_specific_algo_params)
          : base(_default_title, bus, factory, SparkCommands.ShowOrders.icon) {
          _model = model;
          _factory = factory;
          _notification_service = notification_service;
          _state = state;
          _settings_manager = settings_manager;
+         _can_edit_specific_algo_params = can_edit_specific_algo_params;
          thread_id = config.Configuration.get<bts.config.MultiThreadedWindows>().order_book ? "OrderBook" : null;
       }
 
@@ -64,12 +71,14 @@ namespace mbts.spark {
       public string thread_id { get; }
 
       public override void Dispose() {
-         _commands.OfType<IDisposable>().DisposeAll();
+         Disposable.dispose(_thread_init_resources);
          Disposable.dispose(ref _attachment_exit_sub);
          Disposable.dispose(ref _vm);
       }
 
       public void thread_init() {
+         Log.assert(_thread_init_resources == null, $"{nameof(_thread_init_resources)} must be initialized in thread_init.");
+         _thread_init_resources = new List<IDisposable>();
          _menu_display_vm = new SparkMenuDisplayVM();
          if (_state != null)
             _menu_display_vm.load_from(_state.menu_display);
@@ -147,6 +156,15 @@ namespace mbts.spark {
             can_execute: () => _vm.selected_orders.Any(x => passes_recreate_search_criteria(x))
          );
          recreate_selected_orders_command.group = CommandGroups.Modify;
+         ICommand edit_algo_params_cmd;
+         if (_can_edit_specific_algo_params) {
+            _thread_init_resources.Add(CommandHelper.bind_param_source(
+               new DialogCommand<OrderSecurityAlgo?, Window>(mk_algo_params_dialog, has_algo_params),
+               _vm.subscribe_single_selected_order(),
+               out edit_algo_params_cmd, true));
+         } else {
+            edit_algo_params_cmd = DelegateCommand.empty;
+         }
 
          var attach_selected_orders_command = new SparkCommandCommand(
             "Attach To Selected",
@@ -194,14 +212,22 @@ namespace mbts.spark {
          show_grid_settings_command.group = CommandGroups.Auxiliary;
 
          _commands = new SparkCommand[] {
+            // modify commands
             toggle_show_right_panel_command,
             attach_selected_orders_command,
             detach_selected_orders_command,
             recreate_selected_orders_command,
+            new SparkCommandCommand("Algo Params...", Icons.Algo, edit_algo_params_cmd) {
+               group = CommandGroups.Modify,
+               show_in_toolbar = false,
+               show_in_context_menu = _can_edit_specific_algo_params
+            },
+            // cancel commands
             cancel_selected_orders_command,
             cancel_buy_orders_command,
             cancel_sell_orders_command,
             cancel_all_orders_command,
+
             toggle_collapse_all_command,
             toggle_expand_all_command,
             show_grid_settings_command,
@@ -210,9 +236,12 @@ namespace mbts.spark {
             hidden_cmd(new SparkCommandCommand(OrderBookView.CommandDescriptions.RevertOrders, null, _vm.revert_selected_orders_cmd, OrderBookView.KeyboardShortcuts.RevertOrders)),
             _menu_display_vm.spark_cmd
          };
-         _vm.as_demuxer().subscribe<bool>(nameof(OrderBookVM.show_right_panel))
-            .Subscribe(_ => toggle_show_right_panel_command.title = get_toggle_show_right_panel_cmd_title());
+         _thread_init_resources.AddRange(_commands.OfType<IDisposable>());
+         _thread_init_resources.Add(_vm.as_demuxer()
+            .subscribe<bool>(nameof(OrderBookVM.show_right_panel))
+            .Subscribe(_ => toggle_show_right_panel_command.title = get_toggle_show_right_panel_cmd_title()));
          _vm.selected_order_changed += vm_selected_order_changed;
+         _thread_init_resources.Add(Disposable.Create(() => _vm.selected_order_changed -= vm_selected_order_changed));
          // local methods
          string get_toggle_show_right_panel_cmd_title() =>
             _vm.show_right_panel ? OrderBookView.CommandDescriptions.HideRightPanel : OrderBookView.CommandDescriptions.ShowRightPanel;
@@ -234,6 +263,36 @@ namespace mbts.spark {
             attach_selected_orders_command.raiseCanExecuteChanged();
             detach_selected_orders_command.raiseCanExecuteChanged();
          }
+
+         bool has_algo_params(OrderSecurityAlgo? order) =>
+            order.HasValue && !OrderDataHelper.get_metadata(order.Value.algo.value.CustomCase).NoProps;
+
+         Window mk_algo_params_dialog(OrderSecurityAlgo? order) {
+            if (!has_algo_params(order))
+               return null;
+            var algo_def = AlgoDefinitionVM.create(_model, order.Value.algo, editing_permissions: AlgoEditingPermissions.AllowEditValues);
+            var algo_params_vm = new OrderBookAlgoParamsVM(algo_def, order.Value.order.is_non_terminal());
+            var dialog = new OrderBookAlgoParamsDialog {
+               Content = algo_params_vm
+            };
+            ui.WindowStyle.SetTitleContent(dialog, algo_def);
+            dialog.Closed += (s, e) => {
+               Disposable.dispose(ref algo_params_vm);
+               dialog = null;
+            };
+            algo_params_vm.RequestCommit += commit;
+            algo_params_vm.RequestClose += (s, e) => close_dialog();
+            return dialog;
+
+            void close_dialog() {
+               dialog?.Close();
+               dialog = null;
+            }
+            void commit(CustomOrderDefinitionImmutable value) {
+               _model.update_order(order.Value.order, new_algo: value).ignore();
+               close_dialog();
+            }
+         }
       }
 
       protected override void OnParentViewCreated(SparkWindowView parent_view) {

src/client/spark/Modules/Trading/OrderBook/OrderBookWindowFactory.cs

@@ -1,6 +1,7 @@
 using bts.api;
 using bts.shell.orderbook;
 using bts.spark;
+using mbts.config;
 using mbts.persist;
 using mbts.spark;
 using mbts.ui;
@@ -15,8 +16,11 @@ namespace bts.shell {
       readonly INotificationServiceDataCache _notification_service_data_cache;
       readonly OrdersModel _model;
       readonly UserSettingsHub _settings_hub;
+      readonly OrderBookConfig _config;
 
       public OrderBookWindowFactory(IShellModule owner, IBus bus, INotificationService notification_service, INotificationServiceDataCache notification_service_data_cache, OrdersModel model, UserSettingsHub settings_hub) : base(owner, "SparkOrderBookWindow") {
+         var raw_config = Configuration.get<bts.config.OrderBookOptions>();
+         _config = new OrderBookConfig(raw_config.can_edit_specific_algo_params);
          _bus = bus;
          _notification_service = notification_service;
          _notification_service_data_cache = notification_service_data_cache;
@@ -29,7 +33,8 @@ namespace bts.shell {
          var settings_manager = new WindowSettingsManager<OrderBookGridSettings>(_settings_hub, state.grid_settings_wrapper(),
             us => us.order_book_grid ?? OrderBookStartupData.DefaultGrid,
             (us, s) => us.with(order_book_grid: s));
-         var w = new OrderBookWindow(_model, this, _bus, _notification_service, state, SparkCommands.ShowOrders.icon, settings_manager.as_non_shared());
+         var w = new OrderBookWindow(_model, this, _bus, _notification_service, state,
+            SparkCommands.ShowOrders.icon, settings_manager.as_non_shared(), _config.can_edit_specific_algo_params);
          return Task.FromResult<IShellWindow>(w);
       }
 
@@ -37,5 +42,12 @@ namespace bts.shell {
          var w = await load(startup_data);
          _bus.post(SparkTags.ShowWindow, w);
       }
+
+      readonly struct OrderBookConfig {
+         public readonly bool can_edit_specific_algo_params;
+
+         public OrderBookConfig(bool can_edit_specific_algo_params) =>
+            this.can_edit_specific_algo_params = can_edit_specific_algo_params;
+      }
    }
 }

src/client/spark/Modules/Trading/OrderBook/View/OrderBookAlgoParamsDialog.xaml

@@ -0,0 +1,40 @@
+<Window
+  x:Class="bts.shell.orderbook.OrderBookAlgoParamsDialog"
+  x:ClassModifier="internal"
+  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+  xmlns:sp="clr-namespace:mbts.spark"
+  xmlns:ob="clr-namespace:bts.shell.orderbook"
+  xmlns:usp="clr-namespace:mbts.ui.spark"
+  xmlns:u="clr-namespace:mbts.ui"
+  xmlns:c="clr-namespace:mbts.ui.controls"
+  u:WindowStyle.SizeToContent="WidthAndHeight"
+  Margin="0"
+  Padding="0"
+  Style="{StaticResource BTSWindowTitleTemplate}"
+>
+  <u:WindowStyle.TitleContentTemplate>
+    <DataTemplate DataType="{x:Type sp:AlgoDefinitionVM}">
+      <StackPanel HorizontalAlignment="Left" Orientation="Horizontal">
+        <usp:OrderTypeItem Margin="4,0" DisplayName="{Binding name, StringFormat='{}{0} Params'}" BadgeFill="{Binding badge_fill}"/>
+      </StackPanel>
+    </DataTemplate>
+  </u:WindowStyle.TitleContentTemplate>
+  <Window.ContentTemplate>
+    <DataTemplate DataType="{x:Type ob:OrderBookAlgoParamsVM}">
+      <Grid>
+        <Grid.RowDefinitions>
+          <RowDefinition Height="*"/>
+          <RowDefinition Height="Auto"/>
+        </Grid.RowDefinitions>
+        <usp:AlgoEditorGridView
+          Width="390"
+          Margin="5"
+          AlgoParamRows="{Binding param_rows}"
+          CanUserChangeAlgoRoot="False"
+        />
+        <c:DialogSkirt Grid.Row="1" RightItems="{Binding dialog_skirt}"/>
+      </Grid>
+    </DataTemplate>
+  </Window.ContentTemplate>
+</Window>

src/client/spark/Modules/Trading/OrderBook/View/OrderBookAlgoParamsDialog.xaml.cs

@@ -0,0 +1,49 @@
+using bts.api.orderman;
+using bts.collections;
+using mbts.spark;
+using mbts.ui;
+using mbts.ui.controls;
+using mbts.ui.shell;
+using System;
+using System.Collections.Generic;
+using System.Windows;
+
+namespace bts.shell.orderbook {
+   /// <summary>
+   /// Interaction logic for OrderBookAlgoParamsDialog.xaml
+   /// </summary>
+   partial class OrderBookAlgoParamsDialog : Window {
+      public OrderBookAlgoParamsDialog() =>
+         InitializeComponent();
+   }
+
+   class OrderBookAlgoParamsVM : DisposableViewModelBase, IRequestViewClose {
+      readonly ObservableAggregateCollection<AlgoParamRowVM> _param_rows = new ObservableAggregateCollection<AlgoParamRowVM>();
+      readonly DialogSkirtItem _commit, _cancel;
+
+      public OrderBookAlgoParamsVM(AlgoDefinitionVM algo_definition, bool can_user_edit) {
+         this.algo_definition = algo_definition;
+         _dispose = AlgoParamRowsHelper.connect(algo_definition, _param_rows, false);
+         _commit = new DialogSkirtItem("OK", new DelegateCommand(commit, () => can_user_edit)) { is_default = true };
+         _cancel = new DialogSkirtItem("Cancel", new DelegateCommand(close)) { is_cancel = true };
+         // local methods
+         void commit() {
+            RequestCommit?.Invoke(new CustomOrderDefinitionImmutable(algo_definition.algo_root.created_assigned()));
+            close();
+         }
+         void close() => RequestClose?.Invoke(this, EventArgs.Empty);
+      }
+
+      public event EventHandler RequestClose;
+      public event Action<CustomOrderDefinitionImmutable> RequestCommit;
+
+      public AlgoDefinitionVM algo_definition { get; }
+      public IReadOnlyObservableCollection<AlgoParamRowVM> param_rows => _param_rows;
+      public IEnumerable<DialogSkirtItem> dialog_skirt {
+         get {
+            yield return _commit;
+            yield return _cancel;
+         }
+      }
+   }
+}

src/client/spark/Modules/Trading/OrderBook/View/OrderBookView.xaml

@@ -62,7 +62,7 @@
         </Setter>
       </Style>
       <Style x:Key="{x:Static usp:OrderParamsPanel.BestBidSizeButtonStyleKey}" TargetType="Button" BasedOn="{StaticResource {x:Type Button}}">
-        <Setter Property="Command" Value="{Binding DataContext.size_calculator.set_value_command, RelativeSource={RelativeSource AncestorType=usp:OrderParamsPanel}}"/>
+        <Setter Property="Command" Value="{Binding DataContext.size_calculator.set_actual_value_command, RelativeSource={RelativeSource AncestorType=usp:OrderParamsPanel}}"/>
         <Setter Property="CommandParameter" Value="{Binding BestBidSize, RelativeSource={RelativeSource AncestorType=usp:OrderParamsPanel}}"/>
         <Setter Property="ToolTip">
           <Setter.Value>
@@ -82,7 +82,7 @@
         </Setter>
       </Style>
       <Style x:Key="{x:Static usp:OrderParamsPanel.BestAskSizeButtonStyleKey}" TargetType="Button" BasedOn="{StaticResource {x:Type Button}}">
-        <Setter Property="Command" Value="{Binding DataContext.size_calculator.set_value_command, RelativeSource={RelativeSource AncestorType=usp:OrderParamsPanel}}"/>
+        <Setter Property="Command" Value="{Binding DataContext.size_calculator.set_actual_value_command, RelativeSource={RelativeSource AncestorType=usp:OrderParamsPanel}}"/>
         <Setter Property="CommandParameter" Value="{Binding BestAskSize, RelativeSource={RelativeSource AncestorType=usp:OrderParamsPanel}}"/>
         <Setter Property="ToolTip">
           <Setter.Value>
@@ -101,7 +101,7 @@
           <TextBlock.Inlines>
             <Run Text="{Binding security, Mode=OneWay}" FontWeight="Bold"/>
             <Run Text="{Binding side, Mode=OneWay}" Foreground="{Binding side, Converter={StaticResource SideToBrushConverter}}"/>
-            <Run Text="{Binding quantity, Mode=OneWay}"/>
+            <Run Text="{Binding display_quantity, Mode=OneWay}"/>
             <Run>@</Run>
             <Run>
               <Run.Text>
@@ -484,6 +484,7 @@
           <Border Padding="12,12,12,6">
             <Grid>
               <Grid.RowDefinitions>
+                <RowDefinition Height="Auto"/>
                 <RowDefinition Height="Auto"/>
                 <RowDefinition Height="*"/>
               </Grid.RowDefinitions>
@@ -495,7 +496,45 @@
                 AlgoParamRows="{Binding param_rows}"
                 IsReadOnly="{Binding DataContext.can_user_modify_selected_orders, ElementName=Root, Converter={StaticResource NotConverter}}"
               />
-              <StackPanel Grid.Row="1" HorizontalAlignment="Right" VerticalAlignment="Top" Margin="0,8,0,0" Orientation="Horizontal">
+              <c:ExpanderToggleButton
+                x:Name="algo_state_toggle"
+                Grid.Row="1"
+                BorderThickness="0"
+                Content="Algo State"
+                HorizontalContentAlignment="Left"
+                Margin="0,4,0,0"
+                VerticalAlignment="Top"
+                Visibility="{Binding current_algo_custom_state.Count, Converter={StaticResource IntNotZeroVisibilityConverter}}"
+              />
+              <c:DIYGrid Grid.Row="1" Rows="{Binding current_algo_custom_state}" Margin="0,28,0,4">
+                <c:DIYGrid.Visibility>
+                  <MultiBinding>
+                    <MultiBinding.Converter>
+                      <cv:MultiValueConverterPipe>
+                        <cv:BooleanAndConverter/>
+                        <cv:BooleanToVisibilityConverter/>
+                      </cv:MultiValueConverterPipe>
+                    </MultiBinding.Converter>
+                    <Binding Path="current_algo_custom_state.Count" Mode="OneWay" Converter="{StaticResource IntNotZeroConverter}"/>
+                    <Binding Path="IsChecked" ElementName="algo_state_toggle"/>
+                  </MultiBinding>
+                </c:DIYGrid.Visibility>
+                <c:DIYGrid.Columns>
+                  <c:DIYGridColumnCollection>
+                    <c:DIYGridColumn id="Name" Header="Param" Width="176"/>
+                    <c:DIYGridColumn id="Value" Header="Value" Width="176"/>
+                  </c:DIYGridColumnCollection>
+                </c:DIYGrid.Columns>
+                <c:DIYGrid.RowTemplate>
+                  <DataTemplate>
+                    <Grid c:DIYGrid.SyncWithColumnGeometry="True">
+                      <c:TextCell c:DIYGrid.ColumnKey="Name" Text="{Binding name}"/>
+                      <c:TextCell c:DIYGrid.ColumnKey="Value" Text="{Binding value}"/>
+                    </Grid>
+                  </DataTemplate>
+                </c:DIYGrid.RowTemplate>
+              </c:DIYGrid>
+              <StackPanel Grid.Row="2" HorizontalAlignment="Right" VerticalAlignment="Top" Margin="0,8,0,0" Orientation="Horizontal">
                 <Button x:Name="modify_orders_button" Command="{Binding modify_selected_orders_cmd}">
                   <Button.Margin>
                     <Thickness Right="{StaticResource DialogSkirtButtonPadding.Right}"/>

src/client/spark/Modules/Trading/PNL/Data/PNLData.cs

@@ -5,6 +5,7 @@ using bts.utils;
 using mbts;
 using mbts.spark;
 using mbts.spark.utilities;
+using mbts.ui;
 using mbts.ui.controls;
 using mbts.utils;
 using System;
@@ -140,15 +141,18 @@ namespace bts.shell.pnl {
       public PositionPriceSize summary =>
          new PositionPriceSize(long_data.working_total, long_data.avg_price, short_data.working_total, short_data.avg_price);
 
-      public static WorkingOrderData Create(IEnumerable<OrderRecordImmutable> orders) =>
-         orders.Aggregate(Empty, (seed, order) => seed.Add(order));
+      public static WorkingOrderData Create(IEnumerable<OrderRecordImmutable> orders, QuantityConversionData qty_conversion) =>
+         Create(orders.Select(o => (o, qty_conversion)));
 
-      public WorkingOrderData Add(OrderRecordImmutable order) {
+      public static WorkingOrderData Create(IEnumerable<(OrderRecordImmutable order, QuantityConversionData qty_conversion)> orders) =>
+         orders.Aggregate(Empty, (seed, tup) => seed.Add(tup.order, tup.qty_conversion));
+
+      public WorkingOrderData Add(OrderRecordImmutable order, QuantityConversionData qty_conversion) {
          if (order.working_quantity() <= 0)
             return new WorkingOrderData(long_data, short_data);
          switch (order.side()) {
-            case Side.Buy: return new WorkingOrderData(long_data.Add(order), short_data);
-            case Side.Sell: return new WorkingOrderData(long_data, short_data.Add(order));
+            case Side.Buy: return new WorkingOrderData(long_data.Add(order, qty_conversion), short_data);
+            case Side.Sell: return new WorkingOrderData(long_data, short_data.Add(order, qty_conversion));
             default: throw ExceptionBuilder.Argument.unexpected_case(order.side(), "order.side");
          }
       }
@@ -165,18 +169,21 @@ namespace bts.shell.pnl {
    }
 
    readonly struct WorkingOrderSideData {
-      public readonly double avg_price;
-      public readonly ImmutableSortedDictionary<double, ImmutableDictionary<uint, OrderRecordImmutable>> data;
+      public readonly double avg_price, display_avg_price;
+      public readonly ImmutableSortedDictionary<double, ImmutableDictionary<uint, (OrderRecordImmutable order, QuantityConversionData qty_conversion)>> data;
       public readonly int working_total;
+      public readonly int display_working_total;
 
-      WorkingOrderSideData(double avg_price, int working_total, ImmutableSortedDictionary<double, ImmutableDictionary<uint, OrderRecordImmutable>> data) {
+      WorkingOrderSideData(double avg_price, int working_total, double display_avg_price, int display_working_total, ImmutableSortedDictionary<double, ImmutableDictionary<uint, (OrderRecordImmutable, QuantityConversionData)>> data) {
          this.avg_price = avg_price;
          this.working_total = working_total;
+         this.display_avg_price = display_avg_price;
          this.data = data;
+         this.display_working_total = display_working_total;
       }
 
-      public static WorkingOrderSideData EmptyLong => new WorkingOrderSideData(double.NaN, 0, ImmutableSortedDictionary.Create<double, ImmutableDictionary<uint, OrderRecordImmutable>>(new ReverseComparer<double>(OrderDataHelper.PriceComparer)));
-      public static WorkingOrderSideData EmptyShort => new WorkingOrderSideData(double.NaN, 0, ImmutableSortedDictionary.Create<double, ImmutableDictionary<uint, OrderRecordImmutable>>(OrderDataHelper.PriceComparer));
+      public static WorkingOrderSideData EmptyLong => new WorkingOrderSideData(double.NaN, 0, double.NaN, 0, ImmutableSortedDictionary.Create<double, ImmutableDictionary<uint, (OrderRecordImmutable, QuantityConversionData)>>(new ReverseComparer<double>(OrderDataHelper.PriceComparer)));
+      public static WorkingOrderSideData EmptyShort => new WorkingOrderSideData(double.NaN, 0, double.NaN, 0, ImmutableSortedDictionary.Create<double, ImmutableDictionary<uint, (OrderRecordImmutable, QuantityConversionData)>>(OrderDataHelper.PriceComparer));
 
       public double top_price =>
          data.Count > 0 ?
@@ -185,23 +192,35 @@ namespace bts.shell.pnl {
 
       public int top_volume =>
          data.Count > 0 ?
-            data.Values.First().Values.Sum(o => o.working_quantity()) :
+            data.Values.First().Values.Sum(o => o.order.working_quantity()) :
             0;
 
-      public WorkingOrderSideData Add(OrderRecordImmutable order_record) {
-         uint order = order_record.Key;
+      public int display_top_volume =>
+         data.Count > 0 ?
+            data.Values.First().Values.Sum(o => o.qty_conversion.to_display(o.order.working_quantity())) :
+            0;
+
+      public WorkingOrderSideData Add(OrderRecordImmutable order_record) =>
+         Add(order_record, new QuantityConversionData());
+
+      public WorkingOrderSideData Add(OrderRecordImmutable order_record, QuantityConversionData qty_conversion) {
          int working_qty = order_record.working_quantity();
-         double price = order_record.price();
          if (working_qty <= 0)
             throw new ArgumentException(nameof(working_qty));
+         uint order = order_record.Key;
+         int dworking_qty = qty_conversion.to_display(working_qty);
+         double price = order_record.price();
          if (working_total == 0) {
-            return new WorkingOrderSideData(price, working_qty, data.Add(price, ImmutableDictionary<uint, OrderRecordImmutable>.Empty.Add(order, order_record)));
+            Log.assert(display_working_total == 0);
+            return new WorkingOrderSideData(price, working_qty, display_avg_price, dworking_qty, data.Add(price, ImmutableDictionary<uint, (OrderRecordImmutable, QuantityConversionData)>.Empty.Add(order, (order_record, qty_conversion))));
          } else return new WorkingOrderSideData(
               avg_price + ((price - avg_price) * ((double)working_qty / (working_total + working_qty))),
               working_total + working_qty,
+              display_avg_price + ((price - display_avg_price) * ((double)dworking_qty / (display_working_total + dworking_qty))),
+              display_working_total + dworking_qty,
               data.SetItem(price, data.TryGetValue(price, out var curr) ?
-                 curr.Add(order, order_record) :
-                 ImmutableDictionary<uint, OrderRecordImmutable>.Empty.Add(order, order_record)));
+                 curr.Add(order, (order_record, qty_conversion)) :
+                 ImmutableDictionary<uint, (OrderRecordImmutable, QuantityConversionData)>.Empty.Add(order, (order_record, qty_conversion))));
       }
 
       public WorkingOrderSideData Remove(uint order, double price) {
@@ -210,22 +229,30 @@ namespace bts.shell.pnl {
             throw new KeyNotFoundException(nameof(price));
          if (!wdata.TryGetValue(order, out var worder))
             throw new KeyNotFoundException(nameof(order));
-         var wqty = worder.working_quantity();
+         var wqty = worder.order.working_quantity();
+         var dwqty = worder.qty_conversion.to_display(wqty);
          wdata = wdata.Remove(order);
          if (wdata.Count == 0)
             tmp_data = tmp_data.Remove(price);
          if (tmp_data.Count == 0)
-            return new WorkingOrderSideData(double.NaN, 0, ImmutableSortedDictionary.Create<double, ImmutableDictionary<uint, OrderRecordImmutable>>(data.KeyComparer));
+            return new WorkingOrderSideData(double.NaN, 0, double.NaN, 0, ImmutableSortedDictionary.Create<double, ImmutableDictionary<uint, (OrderRecordImmutable, QuantityConversionData)>>(data.KeyComparer));
          return new WorkingOrderSideData(
             avg_price - ((price - avg_price) * (wqty / (working_total - wqty))),
             working_total - wqty,
+            display_avg_price - ((price - display_avg_price) * (dwqty / (display_working_total - dwqty))),
+            display_working_total - dwqty,
             tmp_data);
       }
 
       public override string ToString() {
          if (data.Count > 0) {
             var best_order = data.Values.First().Values.First();
-            return OrderUtils.order_collection_summary(best_order.price(), avg_price, best_order.working_quantity(), working_total, SecurityDataHelper.Defaults.ContractSpecificationImmutable);
+            return OrderUtils.order_collection_summary(
+               best_order.order.price(),
+               display_avg_price,
+               best_order.qty_conversion.to_display(best_order.order.working_quantity()),
+               display_working_total,
+               SecurityDataHelper.Defaults.ContractSpecificationImmutable);
          }
          return string.Empty;
       }
@@ -248,21 +275,25 @@ namespace bts.shell.pnl {
 
       public readonly PNLKey key;
       public readonly SecurityImmutable? security;
+      public readonly QuantityConversionData qty_conversion;
       public readonly string account_name;
       public readonly PNLCalculationType calc_type;
       public readonly PositionPriceSize day, raw_day, sod;
       public readonly WorkingOrderData working;
 
       public readonly double
-         cpp,
+         default_cpp,
          bid_price,
          ask_price,
          last_price,
          settlement_price;
 
+      public readonly double? override_cpp;
+
       public PNLRowData(
          PNLKey key,
-         double cpp = 0,
+         double default_cpp = 0,
+         double? override_cpp = null,
          double bid_price = 0,
          double ask_price = 0,
          double last_price = 0,
@@ -273,10 +304,12 @@ namespace bts.shell.pnl {
          WorkingOrderData? working = null,
          SecurityImmutable? security = null,
          string account_name = null,
-         PNLCalculationType calc_type = PNLCalculationType.Mid) {
+         PNLCalculationType calc_type = PNLCalculationType.Mid,
+         QuantityConversionData? qty_conversion = null) {
          //
          this.key = key;
-         this.cpp = cpp;
+         this.default_cpp = default_cpp;
+         this.override_cpp = override_cpp;
          this.bid_price = bid_price;
          this.ask_price = ask_price;
          this.last_price = last_price;
@@ -288,6 +321,7 @@ namespace bts.shell.pnl {
          this.security = security;
          this.account_name = account_name;
          this.calc_type = calc_type;
+         this.qty_conversion = qty_conversion ?? new QuantityConversionData();
       }
 
       [Flags]
@@ -305,6 +339,9 @@ namespace bts.shell.pnl {
          AskLTESettle = Ask | Settle | 1 << 7
       }
 
+      public string symbol => security?.pnl_symbol() ?? string.Empty;
+      public double effective_cpp => override_cpp ?? default_cpp;
+
       /// Market/Calc
       public double mid_price => (bid_price + ask_price) / 2;
       public double pnl_price {
@@ -344,117 +381,155 @@ namespace bts.shell.pnl {
          }
       }
       /// Sod
-      public double sod_pnl => cpp *
+      public double sod_pnl => effective_cpp *
          DoubleUtil.nan_to_zero_sum(
             sod_long_avg_price_delta_raw * sod_long_pos,
             sod_short_avg_price_delta_raw * sod_short_pos
          );
       // long
       public double sod_long_pos => sod.long_pos;
-      public double sod_long_avg_price => cpp * sod.long_avg;
+      public double sod_long_avg_price => effective_cpp * sod.long_avg;
       public double sod_long_avg_price_raw => sod.long_avg;
-      public double sod_long_avg_price_delta => cpp * sod_long_avg_price_delta_raw;
+      public double sod_long_avg_price_delta => effective_cpp * sod_long_avg_price_delta_raw;
       public double sod_long_avg_price_delta_raw => sod.long_pos == 0 ? double.NaN : long_pnl_price - sod.long_avg;
       // short
       public double sod_short_pos => sod.short_pos;
-      public double sod_short_avg_price => cpp * sod.short_avg;
+      public double sod_short_avg_price => effective_cpp * sod.short_avg;
       public double sod_short_avg_price_raw => sod.short_avg;
-      public double sod_short_avg_price_delta => cpp * sod_short_avg_price_delta_raw;
+      public double sod_short_avg_price_delta => effective_cpp * sod_short_avg_price_delta_raw;
       public double sod_short_avg_price_delta_raw => sod.short_pos == 0 ? double.NaN : sod.short_avg - short_pnl_price;
       // net
       public double sod_net_pos => sod.net_pos;
-      public double sod_net_avg_price_delta => cpp * sod_net_avg_price_delta_raw;
+      public double sod_net_avg_price_delta => effective_cpp * sod_net_avg_price_delta_raw;
       public double sod_net_avg_price_delta_raw =>
          MathUtils.weighted_average(
             sod_long_avg_price_delta_raw, sod.long_pos,
             sod_short_avg_price_delta_raw, sod.short_pos);
+      // display
+      public double display_sod_net_pos => qty_conversion.to_display(sod_net_pos);
+      public double display_sod_long_pos => qty_conversion.to_display(sod_long_pos);
+      public double display_sod_short_pos => qty_conversion.to_display(sod_short_pos);
 
       /// Day
-      public double day_pnl => cpp *
+      public double day_pnl => effective_cpp *
          DoubleUtil.nan_to_zero_sum(
             day_long_avg_price_delta_raw * day_long_pos,
             day_short_avg_price_delta_raw * day_short_pos
          );
       // long
       public double day_long_pos => day.long_pos;
-      public double day_long_avg_price => cpp * day.long_avg;
+      public double day_long_avg_price => effective_cpp * day.long_avg;
       public double day_long_avg_price_raw => day.long_avg;
-      public double day_long_avg_price_delta => cpp * day_long_avg_price_delta_raw;
+      public double day_long_avg_price_delta => effective_cpp * day_long_avg_price_delta_raw;
       public double day_long_avg_price_delta_raw => day.long_pos == 0 ? double.NaN : long_pnl_price - day.long_avg;
       // short
       public double day_short_pos => day.short_pos;
-      public double day_short_avg_price => cpp * day.short_avg;
+      public double day_short_avg_price => effective_cpp * day.short_avg;
       public double day_short_avg_price_raw => day.short_avg;
-      public double day_short_avg_price_delta => cpp * day_short_avg_price_delta_raw;
+      public double day_short_avg_price_delta => effective_cpp * day_short_avg_price_delta_raw;
       public double day_short_avg_price_delta_raw => day.short_pos == 0 ? double.NaN : day.short_avg - short_pnl_price;
       public bool has_day_trades => day.long_pos > 0 || day.short_pos > 0;
       // net
       public double day_net_pos => day.net_pos;
-      public double day_net_avg_price_delta => cpp * day_net_avg_price_delta_raw;
+      public double day_net_avg_price_delta => effective_cpp * day_net_avg_price_delta_raw;
       public double day_net_avg_price_delta_raw =>
          MathUtils.weighted_average(
             day_long_avg_price_delta_raw, day.long_pos,
             day_short_avg_price_delta_raw, day.short_pos);
+      // display
+      public double display_day_net_pos => qty_conversion.to_display(day_net_pos);
+      public double display_day_long_pos => qty_conversion.to_display(day_long_pos);
+      public double display_day_short_pos => qty_conversion.to_display(day_short_pos);
 
       /// Raw Day
       public double raw_day_long_pos => raw_day.long_pos;
       public double raw_day_short_pos => raw_day.short_pos;
       public double raw_day_net_pos => raw_day.net_pos;
+      // display
+      public double display_raw_day_net_pos => qty_conversion.to_display(raw_day_net_pos);
+      public double display_raw_day_long_pos => qty_conversion.to_display(raw_day_long_pos);
+      public double display_raw_day_short_pos => qty_conversion.to_display(raw_day_short_pos);
 
       /// Total
       public double total_pnl => DoubleUtil.nan_to_zero_sum(sod_pnl, day_pnl);
       // long
       public double total_long_pos => DoubleUtil.nan_to_zero_sum(sod.long_pos, day.long_pos);
-      public double total_long_avg_price => cpp * total_long_avg_price_raw;
+      public double total_long_avg_price => effective_cpp * total_long_avg_price_raw;
       public double total_long_avg_price_raw => DoubleUtil.nan_to_zero_sum(sod.long_avg, day.long_avg);
-      public double total_long_avg_price_delta => cpp * total_long_avg_price_delta_raw;
+      public double total_long_avg_price_delta => effective_cpp * total_long_avg_price_delta_raw;
       public double total_long_avg_price_delta_raw =>
          MathUtils.weighted_average(
             sod_long_avg_price_delta_raw, sod.long_pos,
             day_long_avg_price_delta_raw, day.long_pos);
       // short
       public double total_short_pos => DoubleUtil.nan_to_zero_sum(sod.short_pos, day.short_pos);
-      public double total_short_avg_price => cpp * total_short_avg_price_raw;
+      public double total_short_avg_price => effective_cpp * total_short_avg_price_raw;
       public double total_short_avg_price_raw => DoubleUtil.nan_to_zero_sum(sod.short_avg, day.short_avg);
-      public double total_short_avg_price_delta => cpp * total_short_avg_price_delta_raw;
+      public double total_short_avg_price_delta => effective_cpp * total_short_avg_price_delta_raw;
       public double total_short_avg_price_delta_raw =>
          MathUtils.weighted_average(
             sod_short_avg_price_delta_raw, sod.short_pos,
             day_short_avg_price_delta_raw, day.short_pos);
       // net
       public double total_net_pos => DoubleUtil.nan_to_zero_sum(sod.long_pos, -sod.short_pos, day.long_pos, -day.short_pos);
-      public double total_net_avg_price_delta => cpp * total_net_avg_price_delta_raw;
+      public double total_net_avg_price_delta => effective_cpp * total_net_avg_price_delta_raw;
       public double total_net_avg_price_delta_raw =>
          MathUtils.weighted_average(
             total_long_avg_price_delta_raw, total_long_pos,
             total_short_avg_price_delta_raw, total_short_pos);
+      // display
+      public double display_total_net_pos => qty_conversion.to_display(total_net_pos);
+      public double display_total_long_pos => qty_conversion.to_display(total_long_pos);
+      public double display_total_short_pos => qty_conversion.to_display(total_short_pos);
 
       #region Working
       // long
       public double working_long_pos => working.long_data.working_total;
-      public double working_long_avg_price => cpp * working_long_avg_price_raw;
-      public double working_long_top_price => cpp * working_long_top_price_raw;
+      public double working_long_avg_price => effective_cpp * working_long_avg_price_raw;
+      public double working_long_top_price => effective_cpp * working_long_top_price_raw;
       public double working_long_top_price_raw => working.top_bid;
       public double working_long_avg_price_raw => working.long_data.avg_price;
-      public double working_long_avg_price_delta => cpp * working_long_avg_price_delta_raw;
+      public double working_long_avg_price_delta => effective_cpp * working_long_avg_price_delta_raw;
       public double working_long_avg_price_delta_raw => working_long_pos == 0 ? double.NaN : long_pnl_price - working_long_avg_price_raw;
       // short
       public double working_short_pos => working.short_data.working_total;
-      public double working_short_avg_price => cpp * working_short_avg_price_raw;
-      public double working_short_top_price => cpp * working_short_top_price_raw;
+      public double working_short_avg_price => effective_cpp * working_short_avg_price_raw;
+      public double working_short_top_price => effective_cpp * working_short_top_price_raw;
       public double working_short_top_price_raw => working.top_ask;
       public double working_short_avg_price_raw => working.short_data.avg_price;
-      public double working_short_avg_price_delta => cpp * working_short_avg_price_delta_raw;
+      public double working_short_avg_price_delta => effective_cpp * working_short_avg_price_delta_raw;
       public double working_short_avg_price_delta_raw => working_short_pos == 0 ? double.NaN : working_short_avg_price_raw - short_pnl_price;
       // net
       public double working_net_pos => working_long_pos - working_short_pos;
-      public double working_net_avg_price_delta => cpp * working_net_avg_price_delta_raw;
+      public double working_net_avg_price_delta => effective_cpp * working_net_avg_price_delta_raw;
       public double working_net_avg_price_delta_raw =>
          MathUtils.weighted_average(
             working_long_avg_price_delta_raw, working_long_pos,
             working_short_avg_price_delta_raw, working_short_pos);
+      // display
+      public double display_working_net_pos => qty_conversion.to_display(working_net_pos);
+      public double display_working_long_pos => qty_conversion.to_display(working_long_pos);
+      public double display_working_short_pos => qty_conversion.to_display(working_short_pos);
       #endregion
 
+      public PNLRowData with(SecurityImmutable? security = null, string account_name = null, WorkingOrderData? working = null, PNLCalculationType? calc_type = null) =>
+         new PNLRowData(
+            key,
+            default_cpp,
+            override_cpp,
+            bid_price,
+            ask_price,
+            last_price,
+            settlement_price,
+            sod,
+            day,
+            raw_day,
+            working ?? this.working,
+            security ?? this.security,
+            account_name ?? this.account_name,
+            calc_type ?? this.calc_type,
+            qty_conversion: qty_conversion);
+
       WaterfallPriceFlags _waterfall_flags() {
          var flags = WaterfallPriceFlags.None;
          if (!double.IsNaN(bid_price)) flags |= WaterfallPriceFlags.Bid;
@@ -496,7 +571,8 @@ namespace bts.shell.pnl {
 
       public bool Equals(PNLRowData other) =>
          key == other.key &&
-         cpp == other.cpp &&
+         default_cpp == other.default_cpp &&
+         override_cpp == other.override_cpp &&
          security.HasValue == other.security.HasValue &&
          account_name == other.account_name &&
          sod == other.sod &&
@@ -508,7 +584,8 @@ namespace bts.shell.pnl {
          settlement_price.Equals(other.settlement_price) &&
          calc_type.Equals(other.calc_type) &&
          raw_day == other.raw_day &&
-         working.summary == other.working.summary;
+         working.summary == other.working.summary &&
+         qty_conversion == other.qty_conversion;
 
       public override bool Equals(object obj) =>
          obj is PNLRowData other && Equals(other);
@@ -523,9 +600,12 @@ namespace bts.shell.pnl {
    }
 
    static class PNLRowDataFactory {
-      public static PNLRowData create((SecurityImmutable? sec, PNLUnitImmutable value) t) =>
-         new PNLRowData(new PNLKey(t.value.Pos.AccountId, t.value.Pos.SecurityId),
-            t.value.CashValue,
+      public static PNLRowData create((SecurityImmutable? sec, PNLUnitImmutable value, QuantityConversionData qty_conversion) t) {
+         var (default_cpp, override_cpp) = t.value.pnl_cpp_tuple(t.sec);
+         return new PNLRowData(
+            new PNLKey(t.value.Pos.AccountId, t.value.Pos.SecurityId),
+            default_cpp,
+            override_cpp,
             t.value.BidPrice,
             t.value.AskPrice,
             t.value.LastPrice,
@@ -535,25 +615,29 @@ namespace bts.shell.pnl {
             t.value.Pos.raw_day_pps(),
             WorkingOrderData.Empty,
             t.sec,
-            t.value.Pos.Account);
+            t.value.Pos.Account,
+            qty_conversion: t.qty_conversion);
+      }
    }
 
    static class PNLDataExtensions {
-      // Note: PNLRowData is passed by ref because it is fairly large struct, and since it is a readonly struct, we know it cannot be modified (so might as well avoid excessive copying).
-      public static PNLRowData with(this PNLRowData pnl_data, SecurityImmutable? security = null, string account_name = null, WorkingOrderData? working = null, PNLCalculationType? calc_type = null) =>
-         new PNLRowData(
-            pnl_data.key,
-            pnl_data.cpp,
-            pnl_data.bid_price,
-            pnl_data.ask_price,
-            pnl_data.last_price,
-            pnl_data.settlement_price,
-            pnl_data.sod,
-            pnl_data.day,
-            pnl_data.raw_day,
-            working ?? pnl_data.working,
-            security ?? pnl_data.security,
-            account_name ?? pnl_data.account_name,
-            calc_type ?? pnl_data.calc_type);
+      public static string pnl_symbol(this SecurityImmutable security) {
+         if(security.HasIce)
+            return PNLICEHelper.get_symbol(security);
+         return security.Symbol;
+      }
+
+      // while override_cpp could use double.NaN to indicate the lack of an override,
+      // the nullable double makes it clear that it is an optional value.
+      public static (double default_cpp, double? override_cpp) pnl_cpp_tuple(this PNLUnitImmutable pnl_unit, SecurityImmutable? security) =>
+         security.HasValue ?
+            pnl_cpp_tuple(pnl_unit, security.Value) :
+            (pnl_unit.CashValue, pnl_unit.HasCppOverride ? pnl_unit.CppOverride.Value : (double?)null);
+
+      public static (double default_cpp, double? override_cpp) pnl_cpp_tuple(this PNLUnitImmutable pnl_unit, SecurityImmutable security) {
+         // TODO: actual impl
+         double calced_pnl = PNLICEHelper.get_cpp(pnl_unit,security);
+         return (calced_pnl, /*pnl_unit.HasCppOverride ? pnl_unit.CppOverride.Value : */(double?)null);
+      }
    }
-}
+}

src/client/spark/Modules/Trading/PNL/Data/PNLICEHelper.cs

@@ -0,0 +1,77 @@
+using bts.api;
+using bts.api.orderman;
+using bts.api.position;
+using bts.utils;
+using mbts;
+using System;
+using System.Collections.Generic;
+using System.Collections.Immutable;
+
+
+namespace bts.shell.pnl {
+
+static class PNLICEHelper{   
+
+   public static bool is_spread(SecurityImmutable sec){
+      return sec.HasSpread && sec.Ice.StripName.Contains("/");
+   }
+
+   public static bool is_strip(SecurityImmutable sec){
+      return sec.HasSpread && !is_spread(sec);
+   }
+
+   public static bool is_ice_lots(SecurityImmutable sec){
+      return sec.Ice.MarketDescription.Contains("ICE Lots");
+   }   
+
+   public static double get_future_cpp (SecurityImmutable sec){
+      if(sec.Symbol == "HHD")
+         return 1;
+      if(is_ice_lots(sec))
+         return 2500;
+      else{
+         var days_in_month = DateTime.DaysInMonth(Convert.ToInt32(sec.Future.ExpirationYear),
+                                                  Convert.ToInt32(sec.Future.ExpirationMonth));
+         return days_in_month; // because the size is multiplied by 2500 already
+      }
+   }
+
+   public static double get_spread_cpp(SecurityImmutable sec){
+      return 0;
+   }
+
+   public static double get_strip_cpp(PNLUnitImmutable pnl,
+                                      SecurityImmutable sec){
+      double rv = 0;
+      foreach (var l in sec.Spread.Legs)
+         if(l.Security.HasFuture)
+            rv += get_cpp(pnl,l.Security);
+      return rv;
+   }
+
+   public static string get_symbol (SecurityImmutable sec){
+      var rv = String.Format("{0}{1}{2}",
+                            sec.Symbol,
+                            is_ice_lots(sec)? " ICE LOTS" : String.Empty,
+                            is_spread(sec)? " Spread" : String.Empty);
+      return rv;
+   }
+
+   public static double get_cpp (PNLUnitImmutable pnl,
+                                 SecurityImmutable sec){
+      if(sec.Symbol == "HHD")
+         Console.WriteLine("yes!");
+      if (sec.HasGlbx)
+         return pnl.CashValue;
+      else if (sec.HasIce){
+         if(sec.HasFuture)
+            return get_future_cpp(sec);
+         else if(is_spread(sec))
+            return get_spread_cpp(sec);
+         else if(is_strip(sec))
+            return get_strip_cpp(pnl,sec);
+      }
+      return Double.NaN;
+   }
+
+}}

src/client/spark/Modules/Trading/PNL/Data/PNLNormalizedData.cs

@@ -16,7 +16,15 @@ namespace bts.shell.pnl {
          decimal sod_long_pos,
          decimal sod_short_pos,
          decimal working_long_pos = 0,
-         decimal working_short_pos = 0) {
+         decimal working_short_pos = 0,
+         decimal? display_day_long_pos = null,
+         decimal? display_day_short_pos = null,
+         decimal? display_raw_day_long_pos = null,
+         decimal? display_raw_day_short_pos = null,
+         decimal? display_sod_long_pos = null,
+         decimal? display_sod_short_pos = null,
+         decimal? display_working_long_pos = null,
+         decimal? display_working_short_pos = null) {
          //
          this.day_pnl = day_pnl;
          this.day_long_pos = day_long_pos;
@@ -28,6 +36,15 @@ namespace bts.shell.pnl {
          this.sod_short_pos = sod_short_pos;
          this.working_long_pos = working_long_pos;
          this.working_short_pos = working_short_pos;
+         // display
+         this.display_day_long_pos = display_day_long_pos ?? day_long_pos;
+         this.display_day_short_pos = display_day_short_pos ?? day_short_pos;
+         this.display_raw_day_long_pos = display_raw_day_long_pos ?? raw_day_long_pos;
+         this.display_raw_day_short_pos = display_raw_day_short_pos ?? raw_day_short_pos;
+         this.display_sod_long_pos = display_sod_long_pos ?? sod_long_pos;
+         this.display_sod_short_pos = display_sod_short_pos ?? sod_short_pos;
+         this.display_working_long_pos = display_working_long_pos ?? working_long_pos;
+         this.display_working_short_pos = display_working_short_pos ?? working_short_pos;
       }
 
       // sod
@@ -35,24 +52,48 @@ namespace bts.shell.pnl {
       public decimal sod_long_pos { get; }
       public decimal sod_short_pos { get; }
       public decimal sod_net_pos => sod_long_pos - sod_short_pos;
+      // sod display
+      public decimal display_sod_long_pos { get; }
+      public decimal display_sod_short_pos { get; }
+      public decimal display_sod_net_pos => display_sod_long_pos - display_sod_short_pos;
+
       // day
       public decimal day_pnl { get; }
       public decimal day_long_pos { get; }
       public decimal day_short_pos { get; }
       public decimal day_net_pos => day_long_pos - day_short_pos;
+      // display
+      public decimal display_day_long_pos { get; }
+      public decimal display_day_short_pos { get; }
+      public decimal display_day_net_pos => display_day_long_pos - display_day_short_pos;
+
       // raw day
       public decimal raw_day_long_pos { get; }
       public decimal raw_day_short_pos { get; }
       public decimal raw_day_net_pos => raw_day_long_pos - raw_day_short_pos;
+      // display
+      public decimal display_raw_day_long_pos { get; }
+      public decimal display_raw_day_short_pos { get; }
+      public decimal display_raw_day_net_pos => display_raw_day_long_pos - display_raw_day_short_pos;
+
       // total
       public decimal total_pnl => sod_pnl + day_pnl;
       public decimal total_net_pos => total_long_pos - total_short_pos;
       public decimal total_long_pos => sod_long_pos + day_long_pos;
       public decimal total_short_pos => sod_short_pos + day_short_pos;
+      // display
+      public decimal display_total_long_pos => display_sod_long_pos + display_day_long_pos;
+      public decimal display_total_short_pos => display_sod_short_pos + display_day_short_pos;
+      public decimal display_total_net_pos => display_total_long_pos - display_total_short_pos;
+
       // working
       public decimal working_long_pos { get; }
-      public decimal working_net_pos => working_long_pos - working_short_pos;
       public decimal working_short_pos { get; }
+      public decimal working_net_pos => working_long_pos - working_short_pos;
+      // display
+      public decimal display_working_long_pos { get; }
+      public decimal display_working_short_pos { get; }
+      public decimal display_working_net_pos => display_working_long_pos - display_working_short_pos;
 
       public bool Equals(PNLNormalizedData other) =>
          day_pnl == other.day_pnl &&
@@ -64,6 +105,17 @@ namespace bts.shell.pnl {
          sod_long_pos == other.sod_long_pos &&
          sod_short_pos == other.sod_short_pos &&
          working_long_pos == other.working_long_pos &&
+         working_short_pos == other.working_short_pos &&
+         // display
+         sod_long_pos == other.sod_long_pos &&
+         sod_short_pos == other.sod_short_pos &&
+         day_long_pos == other.day_long_pos &&
+         day_short_pos == other.day_short_pos &&
+         raw_day_long_pos == other.raw_day_long_pos &&
+         raw_day_short_pos == other.raw_day_short_pos &&
+         total_long_pos == other.total_long_pos &&
+         total_short_pos == other.total_short_pos &&
+         working_long_pos == other.working_long_pos &&
          working_short_pos == other.working_short_pos;
 
       public override bool Equals(object obj) =>
@@ -102,7 +154,16 @@ namespace bts.shell.pnl {
             a.sod_long_pos + b.sod_long_pos,
             a.sod_short_pos + b.sod_short_pos,
             a.working_long_pos + b.working_long_pos,
-            a.working_short_pos + b.working_short_pos);
+            a.working_short_pos + b.working_short_pos,
+            // display
+            a.display_day_long_pos + b.display_day_long_pos,
+            a.display_day_short_pos + b.display_day_short_pos,
+            a.display_raw_day_long_pos + b.display_raw_day_long_pos,
+            a.display_raw_day_short_pos + b.display_raw_day_short_pos,
+            a.display_sod_long_pos + b.display_sod_long_pos,
+            a.display_sod_short_pos + b.display_sod_short_pos,
+            a.display_working_long_pos + b.display_working_long_pos,
+            a.display_working_short_pos + b.display_working_short_pos);
 
       public static PNLNormalizedData operator -(PNLNormalizedData a, PNLNormalizedData b) =>
          new PNLNormalizedData(
@@ -115,6 +176,15 @@ namespace bts.shell.pnl {
             a.sod_long_pos - b.sod_long_pos,
             a.sod_short_pos - b.sod_short_pos,
             a.working_long_pos - b.working_long_pos,
-            a.working_short_pos - b.working_short_pos);
+            a.working_short_pos - b.working_short_pos,
+            // display
+            a.display_day_long_pos - b.display_day_long_pos,
+            a.display_day_short_pos - b.display_day_short_pos,
+            a.display_raw_day_long_pos - b.display_raw_day_long_pos,
+            a.display_raw_day_short_pos - b.display_raw_day_short_pos,
+            a.display_sod_long_pos - b.display_sod_long_pos,
+            a.display_sod_short_pos - b.display_sod_short_pos,
+            a.display_working_long_pos - b.display_working_long_pos,
+            a.display_working_short_pos - b.display_working_short_pos);
    }
 }

src/client/spark/Modules/Trading/PNL/PNLWindowFactory.cs

@@ -1,4 +1,5 @@
 using bts.api;
+using bts.api.position;
 using bts.collections;
 using bts.settings;
 using bts.shell.pnl;
@@ -11,6 +12,7 @@ using mbts.persist;
 using mbts.spark;
 using mbts.ui;
 using mbts.ui.controls;
+using mbts.ui.controls.property_editor;
 using mbts.ui.settings;
 using mbts.ui.spark;
 using mbts.ui.utility;
@@ -22,6 +24,7 @@ using System.ComponentModel;
 using System.ComponentModel.Composition;
 using System.Linq;
 using System.Reactive.Linq;
+using System.Threading;
 using System.Threading.Tasks;
 using System.Windows;
 using System.Windows.Media;
@@ -34,11 +37,13 @@ namespace bts.shell {
       readonly UserSettingsHub _settings_hub;
       readonly PNLConfig _pnl_conf;
       readonly IShellWindowThreadIDProvider _thread_id_provider;
+      readonly IPositionModel _position_model;
 
-      public PNLWindowFactory(IShellModule owner, IBus bus, UserSettingsHub settings_hub, OrdersModel orders_model) : base(owner, _window_type) {
+      public PNLWindowFactory(IShellModule owner, IBus bus, UserSettingsHub settings_hub, OrdersModel orders_model, IPositionModel position_model) : base(owner, _window_type) {
          _bus = bus;
          _orders_model = orders_model;
          _settings_hub = settings_hub;
+         _position_model = position_model;
          _pnl_conf = new PNLConfig(Configuration.get<bts.config.PNLOptions>());
          _thread_id_provider = ShellWindowThreadIDFactory.create(_window_type, Configuration.get<bts.config.MultiThreadedWindows>().pnl);
          _dispose = bus.subscribe(SparkTags.ShowPNLTag).OnDispatcher().Subscribe(_show);
@@ -105,6 +110,8 @@ namespace bts.shell {
                   menu_display: menu_display_vm.create());
                return new PNLSaveState { use_defaults = false, settings = state };
             };
+
+            IDisposable cpp_override_dialog = null;
             IEnumerable<SparkCommand> commands = new[] {
                new SparkCommandCommand("Collapse All", Icons.RightArrow, new DelegateCommand(() => vm.set_all_expanded(false))),
                new SparkCommandCommand("Expand All", Icons.DownArrow, new DelegateCommand(() => vm.set_all_expanded(true))),
@@ -116,6 +123,26 @@ namespace bts.shell {
                   show_in_context_menu = _pnl_conf.show_pause_resume,
                   show_in_toolbar = _pnl_conf.show_pause_resume
                },
+               new SparkCommandCommand("Override CPP...", Icons.CurrencyExchange, new DelegateCommand(() => {
+                  Disposable.dispose(ref cpp_override_dialog);
+                  var security_keys = vm.selected_rows.Select(r => r.security_key.value).Distinct().ToList();
+                  double initial_cpp = vm.selected_rows.Select(r => r.cpp.value).Distinct().SafeSingleOrDefault();
+                  override_cpp_async().ignore();
+                  async Task override_cpp_async() {
+                     try {
+                        var cts = new CancellationTokenSource();
+                        cpp_override_dialog = Disposable.Create(new Action(cts.Cancel));
+                        var (cpp, committed) = await PropertyEditor.get_double_async("Override CPP", "value", cts.Token, initial_cpp);
+                        if (committed && cpp.is_real_positive())
+                           await _position_model.override_cpp_async(security_keys, cpp);
+                     } catch (Exception ex) {
+                        Log.Ui.warn($"Error overriding cpp: {ex}.");
+                     }
+                  }
+               })) {
+                  show_in_context_menu = true,
+                  show_in_toolbar = false
+               },
                SparkCommands.window_settings_command(new DialogCommand(() => {
                   settings_manager.instance_settings = get_save_state().settings;
                   var dialog_vm = new ShellSettingsDialogVM<PNLSettings, PNLSettingsVM>(
@@ -190,6 +217,7 @@ namespace bts.shell {
                         cached_columns.RemoveRange(e.OldItems.OfType<DIYGrid.ColumnBase>());
                }),
                Disposable.wrap_collection(commands.OfType<IDisposable>()),
+               Disposable.Create(() => Disposable.dispose(ref cpp_override_dialog)),
                menu_display_vm,
                vm);
             return (content, commands, get_save_state, dispose);
@@ -384,5 +412,17 @@ namespace bts.shell {
             return false;
          }
       }
+
+      [Export(typeof(IPNLSettingsMigrationRule))]
+      class InitializeDataFormattingMigrationRule : IPNLSettingsMigrationRule {
+         public bool apply(PNLSettings settings, out PNLSettings new_settings) {
+            if (settings != null && settings.data_formatting == null) {
+               new_settings = settings.with(data_formatting: PNLSettings.Default.data_formatting);
+               return true;
+            }
+            new_settings = null;
+            return false;
+         }
+      }
    }
 }

src/client/spark/Modules/Trading/PNL/Settings/PNLFilterStates.cs

@@ -204,11 +204,11 @@ namespace bts.shell.pnl {
          // impl (add all)
          bd.add_discrete_values(fs.account, d => d.key.account_id);
          bd.add_discrete_values(fs.exchange, d => d.security.exchange_or_default());
-         bd.add_discrete_values(fs.symbol, d => d.security.symbol_or_default());
+         bd.add_discrete_values(fs.symbol, d => d.symbol);
          bd.add_discrete_values(fs.security_type, d => d.security.HasValue ? d.security.Value.ContractCase : Security.ContractOneofCase.None);
          bd.add_regex(fs.security, d => d.security.ToString());
          bd.add_regex(fs.security_key, d => d.key.security_id.ToString());
-         bd.add_numeric(fs.cpp, d => d.cpp);
+         bd.add_numeric(fs.cpp, d => d.effective_cpp);
          /// sod
          bd.add_numeric(fs.sod_pnl, d => d.sod_pnl);
          bd.add_numeric(fs.sod_long_pos, d => d.sod_long_pos);

src/client/spark/Modules/Trading/PNL/Settings/VM/PNLDataFormattingVM.cs

@@ -0,0 +1,52 @@
+using bts.utils;
+using mbts.spark;
+using mbts.ui.shell;
+using System;
+using System.Collections.Generic;
+
+namespace bts.shell.pnl {
+   class PNLDataFormattingVM : ViewModelBase, IValueFactory<PNLDataFormatting> {
+      const uint _min_decimal_places = 1, _max_decimal_places = 6;
+      uint _market_price_decimal_places, _fill_price_decimal_places;
+
+      public uint market_price_decimal_places {
+         get => _market_price_decimal_places;
+         set => Set(ref _market_price_decimal_places, value);
+      }
+      public uint fill_price_decimal_places {
+         get => _fill_price_decimal_places;
+         set => Set(ref _fill_price_decimal_places, value);
+      }
+      public IEnumerable<uint> decimal_place_options {
+         get {
+            for (uint n = _min_decimal_places; n <= _max_decimal_places; n++)
+               yield return n;
+         }
+      }
+
+      public PNLDataFormatting create() =>
+         new PNLDataFormatting {
+            fill_price_display = new DoubleFormatting {
+               tick_factors = new mbts.user.settings.TickFactors(
+                  Math.Pow(10, MathUtils.within_range(_min_decimal_places, _max_decimal_places, fill_price_decimal_places)),
+                  1)
+            },
+            market_price_display = new DoubleFormatting {
+               tick_factors = new mbts.user.settings.TickFactors(
+                  Math.Pow(10, MathUtils.within_range(_min_decimal_places, _max_decimal_places, market_price_decimal_places)),
+                  1)
+            }
+         };
+
+      public void load_from(PNLDataFormatting value) {
+         if (value != null) {
+            if (value.market_price_display?.tick_factors != null) {
+               market_price_decimal_places = (uint)Math.Log10(value.market_price_display.tick_factors.tick_base);
+            }
+            if (value.fill_price_display?.tick_factors != null) {
+               fill_price_decimal_places = (uint)Math.Log10(value.fill_price_display.tick_factors.tick_base);
+            }
+         }
+      }
+   }
+}

src/client/spark/Modules/Trading/PNL/Settings/VM/PNLSettingsVM.cs

@@ -14,7 +14,6 @@ using System;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
 using System.Collections.Specialized;
-using System.Dynamic;
 using System.Linq;
 using ColumnKeys = bts.shell.pnl.PNLView.Columns;
 
@@ -52,6 +51,7 @@ namespace bts.shell.pnl {
       public SimpleGridSettingsVM core_settings_vm { get; }
       public PNLGroupRowAppearanceVM group_row_defaults { get; } = new PNLGroupRowAppearanceVM();
       public PNLCellAppearanceVM header_row_defaults { get; } = new PNLCellAppearanceVM();
+      public PNLDataFormattingVM data_formatting_vm { get; } = new PNLDataFormattingVM();
       public PNLCalculationType calculation_type { get => _calculation_type; set => Set(ref _calculation_type, value); }
       public IEnumerable<PNLCalculationType> calculation_types => EnumHelper.get_values_except(PNLCalculationType.None, PNLCalculationType.Same, PNLCalculationType.Opposite);
       public PNLHeaderRowDisplay header_row_display { get => _header_row_display; set => Set(ref _header_row_display, value); }
@@ -63,6 +63,7 @@ namespace bts.shell.pnl {
          var s = _last_loaded == null ? new PNLSettings() : SparkUtils.clone_proto(_last_loaded);
          s.calculation_type = _calculation_type;
          s.grid = core_settings_vm.create();
+         s.data_formatting = data_formatting_vm.create();
          // move anchor cols to the left, order wrt grouping hierarchy
          List<GridColumnSettings> new_cols = null;
          IEnumerable<GridColumnSettings> cols = s.grid.columns;
@@ -136,6 +137,7 @@ namespace bts.shell.pnl {
          _last_loaded = value;
          header_row_defaults.load(value.header_cell_appearance.to_appearance());
          group_row_defaults.load_from((value.group_cell_appearance.to_appearance(), value.group_background_colors.WrapSelectorRO(c => c.argb_color())));
+         data_formatting_vm.load_from(value.data_formatting);
          var column_map = _map_column_data(value.grid.columns, value.animations);
          var group_column_map = _map_column_data(value.group_columns, value.group_header_animations);
          var header_column_map = _map_column_data(value.header_columns, value.header_row_animations);
@@ -154,7 +156,7 @@ namespace bts.shell.pnl {
             anchor_items.WrapSelector(a => a.key, k => _anchor_cache[k]).sync_with(value.anchors.Intersect(PNLSettings.anchorable_columns));
          header_row_display = value.header_row_display;
          calculation_type = value.calculation_type;
-       }
+      }
 
       PNLSettings IValueFactory<PNLSettings>.create() => get_result();
       void IValueFactory<PNLSettings>.load_from(PNLSettings value) => load(value);

src/client/spark/Modules/Trading/PNL/VM/PNLCellIndexBuilder.cs

@@ -14,7 +14,7 @@ namespace bts.shell.pnl {
       public readonly DIYGridAnimationModel<PNLView.Columns, TRow> animation_model = new DIYGridAnimationModel<PNLView.Columns, TRow>(TimeSpan.FromSeconds(0.3));
 
       static readonly Func<WorkingOrderSideData, string> _fmt_working_order_data =
-         d => OrderUtils.order_collection_summary(d.top_price, d.top_volume, d.working_total);
+         d => OrderUtils.order_collection_summary(d.top_price, d.display_top_volume, d.display_working_total);
 
       static readonly IComparer<WorkingOrderSideData> _working_total_comparer =
          Comparer<int>.Default.wrap<int, WorkingOrderSideData>(d => d.working_total);        

src/client/spark/Modules/Trading/PNL/VM/PNLCellVM.cs

@@ -55,11 +55,11 @@ namespace bts.shell.pnl {
    }
 
    class PNLCellVM<TRow, TValue> : ViewModelBase, IObserver<PNLAnimation>, IPNLCellVM<TRow>, IComparable<PNLCellVM<TRow, TValue>>, IComparable {
-      readonly Func<TValue, string> _fmt;
       readonly Func<TRow, TValue> _get;
       readonly IEqualityComparer<TValue> _eq_comparer;
       readonly IComparer<TValue> _comparer;
       readonly PNLView.Columns _column;
+      Func<TValue, string> _fmt;
       IComparer _value_comparer;
       Color
          _foreground = Colors.Black,
@@ -123,6 +123,15 @@ namespace bts.shell.pnl {
          set => Set(ref _font_weight, value);
       }
 
+      public Func<TValue, string> format {
+         get => _fmt;
+         set {
+            _fmt = value;
+            _text = null;
+            RaisePropertyChanged(nameof(text));
+         }
+      }
+
       public void on_row(TRow row) =>
          value = _get(row);
 

src/client/spark/Modules/Trading/PNL/VM/PNLRowVM.cs

@@ -22,7 +22,13 @@ namespace bts.shell.pnl {
       bool _refresh_normalized_data = true, _is_selected;
       PNLNormalizedData _normalized_data;
 
-      public PNLRowVM(PNLRowData data, ImmutableDictionary<ColumnKeys, PNLCellAppearance> default_appearances, IReadOnlyList<IPNLAnimationTrigger<PNLRowData>> triggers) {
+      public PNLRowVM(
+         PNLRowData data,
+         ImmutableDictionary<ColumnKeys, PNLCellAppearance> default_appearances,
+         IReadOnlyList<IPNLAnimationTrigger<PNLRowData>> triggers,
+         Func<double, string> fmt_fill_price,
+         Func<double, string> fmt_market_price) {
+         //
          this.data = data;
          _animator = new PNLCellEmbeddedAnimationModel<PNLRowData>(default_appearances, triggers);
          _animator.on_row(data);
@@ -30,41 +36,41 @@ namespace bts.shell.pnl {
          account_name_cell = _cell_map.add(ColumnKeys.Account, d => d.account_name);
          security_type_cell = _cell_map.add(ColumnKeys.SecurityType, d => d.security?.ContractCase ?? Security.ContractOneofCase.None);
          exchange_cell = _cell_map.add(ColumnKeys.Exchange, d => d.security?.Exchange ?? Venue.Unset);
-         symbol_cell = _cell_map.add(ColumnKeys.Symbol, d => d.security?.Symbol ?? string.Empty);
-         security_cell = _cell_map.add(ColumnKeys.Security, d => d.security, null, EqualityComparer<SecurityImmutable?>.Default, Comparer<SecurityImmutable>.Default.to_nullable());
+         symbol_cell = _cell_map.add(ColumnKeys.Symbol, d => d.symbol);
+         security_cell = _cell_map.add(ColumnKeys.Security, d => (d.security), null, EqualityComparer<SecurityImmutable?>.Default, Comparer<SecurityImmutable>.Default.to_nullable());
          security_key = _cell_map.add(ColumnKeys.SecurityKey, d => d.key.security_id);
-         cpp = _cell_map.add(ColumnKeys.CPP, d => d.cpp);
+         cpp = _cell_map.add(ColumnKeys.CPP, d => d.effective_cpp);
          // sod
          sod_pnl = _cell_map.add_pnl_double(ColumnKeys.SODPNL, d => d.sod_pnl);
-         sod_net_pos = _cell_map.add_net_pos(ColumnKeys.SODNetPos, d => d.sod_net_pos);
-         sod_long_pos = _cell_map.add_long_pos(ColumnKeys.SODLongPos, d => d.sod_long_pos);
+         sod_net_pos = _cell_map.add_net_pos(ColumnKeys.SODNetPos, d => d.display_sod_net_pos);
+         sod_long_pos = _cell_map.add_long_pos(ColumnKeys.SODLongPos, d => d.display_sod_long_pos);
          sod_long_avg_price = _cell_map.add_long_price(ColumnKeys.SODLongAvgPrice, d => d.sod_long_avg_price_raw);
-         sod_short_pos = _cell_map.add_short_pos(ColumnKeys.SODShortPos, d => d.sod_short_pos);
+         sod_short_pos = _cell_map.add_short_pos(ColumnKeys.SODShortPos, d => d.display_sod_short_pos);
          sod_short_avg_price = _cell_map.add_short_price(ColumnKeys.SODShortAvgPrice, d => d.sod_short_avg_price_raw);
          // day
          day_pnl = _cell_map.add_pnl_double(ColumnKeys.DayPNL, d => d.day_pnl);
-         day_net_pos = _cell_map.add_net_pos(ColumnKeys.DayNetPos, d => d.day_net_pos);
-         day_long_pos = _cell_map.add_long_pos(ColumnKeys.DayLongPos, d => d.day_long_pos);
+         day_net_pos = _cell_map.add_net_pos(ColumnKeys.DayNetPos, d => d.display_day_net_pos);
+         day_long_pos = _cell_map.add_long_pos(ColumnKeys.DayLongPos, d => d.display_day_long_pos);
          day_long_avg_price = _cell_map.add_long_price(ColumnKeys.DayLongAvgPrice, d => d.day_long_avg_price_raw);
-         day_short_pos = _cell_map.add_short_pos(ColumnKeys.DayShortPos, d => d.day_short_pos);
+         day_short_pos = _cell_map.add_short_pos(ColumnKeys.DayShortPos, d => d.display_day_short_pos);
          day_short_avg_price = _cell_map.add_short_price(ColumnKeys.DayShortAvgPrice, d => d.day_short_avg_price_raw);
          has_day_trades = _cell_map.add(ColumnKeys.HasDayTrades, d => d.has_day_trades, _fmt_has_day_trades);
          // raw day
-         raw_day_net_pos = _cell_map.add_net_pos(ColumnKeys.RawDayNetPos, d => d.raw_day_net_pos);
-         raw_day_long_pos = _cell_map.add_long_pos(ColumnKeys.RawDayLongPos, d => d.raw_day_long_pos);
-         raw_day_short_pos = _cell_map.add_short_pos(ColumnKeys.RawDayShortPos, d => d.raw_day_short_pos);
+         raw_day_net_pos = _cell_map.add_net_pos(ColumnKeys.RawDayNetPos, d => d.display_raw_day_net_pos);
+         raw_day_long_pos = _cell_map.add_long_pos(ColumnKeys.RawDayLongPos, d => d.display_raw_day_long_pos);
+         raw_day_short_pos = _cell_map.add_short_pos(ColumnKeys.RawDayShortPos, d => d.display_raw_day_short_pos);
          // working
-         working_net_pos = _cell_map.add_net_pos(ColumnKeys.WorkingNetPos, d => d.working_net_pos);
+         working_net_pos = _cell_map.add_net_pos(ColumnKeys.WorkingNetPos, d => d.display_working_net_pos);
          working_long_pos = _cell_map.add_working_long(ColumnKeys.WorkingLongPos, d => d.working.long_data, d => d.bid_price);
          working_long_avg_price = _cell_map.add_long_price(ColumnKeys.WorkingLongAvgPrice, d => d.working_long_avg_price_raw);
          working_short_pos = _cell_map.add_working_short(ColumnKeys.WorkingShortPos, r => r.working.short_data, r => r.ask_price);
          working_short_avg_price = _cell_map.add_short_price(ColumnKeys.WorkingShortAvgPrice, d => d.working_short_avg_price_raw);
          // total
          total_pnl = _cell_map.add_pnl_double(ColumnKeys.TotalPNL, d => d.total_pnl);
-         total_net_pos = _cell_map.add_net_pos(ColumnKeys.TotalNetPos, d => d.total_net_pos);
-         total_long_pos = _cell_map.add_long_pos(ColumnKeys.TotalLongPos, d => d.total_long_pos);
+         total_net_pos = _cell_map.add_net_pos(ColumnKeys.TotalNetPos, d => d.display_total_net_pos);
+         total_long_pos = _cell_map.add_long_pos(ColumnKeys.TotalLongPos, d => d.display_total_long_pos);
          total_long_avg_price = _cell_map.add_long_price(ColumnKeys.TotalLongAvgPrice, d => d.total_long_avg_price_raw);
-         total_short_pos = _cell_map.add_short_pos(ColumnKeys.TotalShortPos, d => d.total_short_pos);
+         total_short_pos = _cell_map.add_short_pos(ColumnKeys.TotalShortPos, d => d.display_total_short_pos);
          total_short_avg_price = _cell_map.add_short_price(ColumnKeys.TotalShortAvgPrice, d => d.total_short_avg_price_raw);
          // market
          bid_price = _cell_map.add_price_double(ColumnKeys.BidPrice, d => d.bid_price);
@@ -73,6 +79,7 @@ namespace bts.shell.pnl {
          last_price = _cell_map.add_price_double(ColumnKeys.LastPrice, d => d.last_price);
          settlement_price = _cell_map.add_price_double(ColumnKeys.SettlementPrice, d => d.settlement_price);
 
+         _set_price_formatting_delegates(fmt_fill_price, fmt_market_price);
          _cell_map.on_row(data);
          _cell_map.set_appearances(_animator.cell_appearances);
          _dispose = _cell_map.animation_model.OnDispatcher().Subscribe(new_animations => {
@@ -112,7 +119,16 @@ namespace bts.shell.pnl {
                   sod_long,
                   sod_short,
                   DoubleUtil.round_to_decimal(data.working_long_pos),
-                  DoubleUtil.round_to_decimal(data.working_short_pos));
+                  DoubleUtil.round_to_decimal(data.working_short_pos),
+                  // display
+                  DoubleUtil.round_to_decimal(data.display_day_long_pos),
+                  DoubleUtil.round_to_decimal(data.display_day_short_pos),
+                  DoubleUtil.round_to_decimal(data.display_raw_day_long_pos),
+                  DoubleUtil.round_to_decimal(data.display_raw_day_short_pos),
+                  DoubleUtil.round_to_decimal(data.display_sod_long_pos),
+                  DoubleUtil.round_to_decimal(data.display_sod_short_pos),
+                  DoubleUtil.round_to_decimal(data.display_working_long_pos),
+                  DoubleUtil.round_to_decimal(data.display_working_short_pos));
                if (_normalized_data != nd) {
                   _normalized_data = nd;
                   updated?.Invoke(nd);
@@ -176,6 +192,7 @@ namespace bts.shell.pnl {
       public PNLCellVM<PNLRowData, double> pnl_price { get; }
 
       public IList<mbts.ui.spark.CellAnimation> animations { get; private set; }
+
       public bool is_selected {
          get => _is_selected;
          set {
@@ -184,6 +201,35 @@ namespace bts.shell.pnl {
          }
       }
 
+      IEnumerable<PNLCellVM<PNLRowData, double>> _market_price_cells {
+         get {
+            yield return pnl_price;
+            yield return last_price;
+            yield return bid_price;
+            yield return mid_price;
+            yield return ask_price;
+            yield return settlement_price;
+         }
+      }
+
+      // includes sod, day, total, and working avg price columns
+      IEnumerable<PNLCellVM<PNLRowData, double>> _fill_price_cells {
+         get {
+            // sod
+            yield return sod_long_avg_price;
+            yield return sod_short_avg_price;
+            // day
+            yield return day_long_avg_price;
+            yield return day_short_avg_price;
+            // total
+            yield return total_long_avg_price;
+            yield return total_short_avg_price;
+            // working
+            yield return working_long_avg_price;
+            yield return working_short_avg_price;
+         }
+      }
+
       public void update(PNLRowData data) {
          _refresh_normalized_data = true;
          this.data = data;
@@ -192,9 +238,10 @@ namespace bts.shell.pnl {
          _cell_map.set_appearances(_animator.cell_appearances);
       }
 
-      public void on_settings(ImmutableDictionary<ColumnKeys, PNLCellAppearance> defaults, IReadOnlyList<IPNLAnimationTrigger<PNLRowData>> triggers) {
+      public void on_settings(ImmutableDictionary<ColumnKeys, PNLCellAppearance> defaults, IReadOnlyList<IPNLAnimationTrigger<PNLRowData>> triggers, Func<double, string> fmt_fill_price, Func<double, string> fmt_market_price) {
          _animator.on_settings(defaults, triggers);
          _cell_map.set_appearances(_animator.cell_appearances);
+         _set_price_formatting_delegates(fmt_fill_price, fmt_market_price);
       }
 
       public bool Equals(PNLRowVM other) =>
@@ -205,5 +252,14 @@ namespace bts.shell.pnl {
 
       public override string ToString() =>
          $"account: {account_name} exchange: {exchange} symbol: {symbol} security: {security} buy_quantity: {day_long_pos} sell_quantity: {day_short_pos} pnl: {total_pnl}";
+
+      void _set_price_formatting_delegates(Func<double, string> fmt_fill_price, Func<double, string> fmt_market_price) {
+         foreach (var cell in _fill_price_cells) {
+            cell.format = fmt_fill_price;
+         }
+         foreach (var cell in _market_price_cells) {
+            cell.format = fmt_market_price;
+         }
+      }
    }
-}
+}

src/client/spark/Modules/Trading/PNL/VM/PNLVM.cs

@@ -41,6 +41,9 @@ namespace bts.shell.pnl {
       readonly IBus _bus;
       readonly OrdersModel _orders_model;
       readonly IObservableCollectionAddRemoveOnly<PNLRowVM> _selected_rows = new ObservableSortedCollection<PNLRowVM>(PNLRowVM.key_comparer);
+      /// treat <see cref="_rows_data_wrapper"/> and <see cref="_rows_key_wrapper"/>
+      /// as IReadOnlyLists - don't call any mutation methods.
+      /// The only reason they are ILists is for the binary_search methods.
       readonly IList<PNLRowData> _rows_data_wrapper;
       readonly IList<PNLKey> _rows_key_wrapper;
       readonly DeferrableActionWrapper _refresh_filter;
@@ -51,6 +54,7 @@ namespace bts.shell.pnl {
       IReadOnlyList<(ColumnKeys key, ListSortDirection direction)> _sorting_hierarchy;
       Brush _selection_highlight;
       Color _grid_background_color = Colors.Transparent;
+      Func<double, string> _fmt_fill_price_backing, _fmt_market_price_backing;
       bool _is_paused;
       // default appearances
       ImmutableDictionary<ColumnKeys, PNLCellAppearance>
@@ -74,7 +78,7 @@ namespace bts.shell.pnl {
       PNLVM(IBus bus, OrdersModel orders_model, PNLSettings settings, IObservable<TableUpdate<PNLRowData, PNLKey>> pnl_source) {
          _bus = bus;
          _orders_model = orders_model;
-         _rows_data_wrapper = rows.WrapSelector(r => r.data, d => new PNLRowVM(d, _default_appearances, _triggers));
+         _rows_data_wrapper = rows.WrapSelector(r => r.data, null);
          _rows_key_wrapper = rows.WrapSelector(r => r.key, null);
          _rows_view = new PNLRowCollectionView(rows, _default_group_appearances, _group_triggers);
          _calculation_type = backing(nameof(calculation_type), PNLCalculationType.Waterfall);
@@ -88,6 +92,12 @@ namespace bts.shell.pnl {
          });
          // filters
          account_filter = DiscreteValuesFilterVM.Common.account<PNLRowData>(orders_model, r => new AccountTuple(r.key.account_id, r.account_name), nameof(PNLRowVM.account_name));
+         symbol_filter = DiscreteValuesFilterVM.CreateTableUpdate<PNLRowData, string, string>(
+            r => r.symbol,
+            sym => sym,
+            out var symbol_filter_items_observer,
+            out var symbol_filter_items_view);
+         symbol_filter_items_view.CustomSort = Comparer<string>.Default.to_safe().to_non_generic();
          _refresh_filter = new DeferrableActionWrapper(() => _filter_changed?.Invoke(get_filters_states().build_predicate()));
          var filter_src = Observable.Create<Func<PNLRowData, bool>>(o => {
             o.OnNext(get_filters_states().build_predicate());
@@ -108,9 +118,11 @@ namespace bts.shell.pnl {
             ).FilterWithRaw(filter_src, PNLRowData.key_fn, null)
             .OnDispatcher()
             .Subscribe(_update),
+            _symbols_source(pnl_source).OnDispatcher().Subscribe(symbol_filter_items_observer),
             Disposable.Create(() => {
                foreach (var f in _all_filters)
                   f.filter_changed -= _refresh_filter.execute;
+               _all_filters.OfType<IDisposable>().DisposeAll();
                rows.DisposeAll();
                _rows_view.Groups.OfTypeSafe<IDisposable>().DisposeAll();
             }));
@@ -187,14 +199,14 @@ namespace bts.shell.pnl {
       /// security
       public IDataGridColumnPersistentFilter<PNLRowData, uint[]> account_filter { get; }
       public IDataGridColumnPersistentFilter<PNLRowData, Venue[]> exchange_filter { get; } = DiscreteValuesFilterVM.Common.exchange<PNLRowData>(r => r.security.exchange_or_default(), nameof(PNLRowVM.exchange));
-      public IDataGridColumnPersistentFilter<PNLRowData, string[]> symbol_filter { get; } = DiscreteValuesFilterVM.Common.symbol<PNLRowData>(r => r.security.symbol_or_default(), nameof(PNLRowVM.symbol));
+      public IDataGridColumnPersistentFilter<PNLRowData, string[]> symbol_filter { get; }
       public IDataGridColumnPersistentFilter<PNLRowData, string> security_filter { get; } = new RegexFilterVM<PNLRowData>(r => r.security?.ToString(), nameof(PNLRowData.security));
       public IDataGridColumnPersistentFilter<PNLRowData, string> security_key_filter { get; } = new RegexFilterVM<PNLRowData>(r => r.key.security_id.ToString());
       public IDataGridColumnPersistentFilter<PNLRowData, SecurityType[]> security_type_filter { get; } = DiscreteValuesFilterVM.Create<PNLRowData, SecurityType>(
          EnumHelper.get_values_except(SecurityType.Option, SecurityType.Synthetic).ToArray(),
          r => r.security?.ContractCase ?? SecurityType.None,
          nameof(PNLRowData.security));
-      public IDataGridColumnPersistentFilter<PNLRowData, DoubleMinMaxState> cpp_filter { get; } = new DoubleMinMax<PNLRowData>(r => r.cpp);
+      public IDataGridColumnPersistentFilter<PNLRowData, DoubleMinMaxState> cpp_filter { get; } = new DoubleMinMax<PNLRowData>(r => r.effective_cpp);
       /// sod
       public IDataGridColumnPersistentFilter<PNLRowData, DoubleMinMaxState> sod_pnl_filter { get; } = new DoubleMinMax<PNLRowData>(r => r.sod_pnl);
       public IDataGridColumnPersistentFilter<PNLRowData, DoubleMinMaxState> sod_long_pos_filter { get; } = new DoubleMinMax<PNLRowData>(r => r.sod.long_pos);
@@ -238,6 +250,15 @@ namespace bts.shell.pnl {
       IEnumerable<IDataGridColumnFilter<PNLRowData>> _all_filters =>
          _filter_getters.Select(get => get(this));
 
+      Func<double, string> _fmt_fill_price {
+         get => _fmt_fill_price_backing ?? FormattingDelegates.Price.Value;
+         set => _fmt_fill_price_backing = value;
+      }
+      Func<double, string> _fmt_market_price {
+         get => _fmt_market_price_backing ?? FormattingDelegates.Price.Value;
+         set => _fmt_market_price_backing = value;
+      }
+
       public static IComparer<PNLRowVM> get_column_comparer(ColumnKeys column) =>
          _get_column_comparer(column).row_comparer;
 
@@ -360,8 +381,10 @@ namespace bts.shell.pnl {
          _triggers = settings.triggers();
          _group_triggers = settings.group_triggers();
          _header_triggers = settings.header_triggers();
+         _fmt_fill_price = settings.data_formatting?.fill_price_display?.get_formatting_delegate();
+         _fmt_market_price = settings.data_formatting?.market_price_display?.get_formatting_delegate();
          foreach (var r in rows)
-            r.on_settings(_default_appearances, _triggers);
+            r.on_settings(_default_appearances, _triggers, _fmt_fill_price, _fmt_market_price);
          total_aggregate.on_settings(settings.header_background_color, _default_header_appearances, _header_triggers);
          selected_aggregate.on_settings(settings.header_background_color,_default_header_appearances, _header_triggers);
          void map_appearances(ref ImmutableDictionary<ColumnKeys, PNLCellAppearance> from, IEnumerable<GridColumnSettings> col_settings, PNLCellAppearance fallback_appearance) {
@@ -542,6 +565,16 @@ namespace bts.shell.pnl {
             yield return col_hash.Contains(c.id) ? c.with(is_visible: false) : c;
       }
 
+      // combines the known system symbols
+      static IObservable<TableUpdate<string, string>> _symbols_source(IObservable<TableUpdate<PNLRowData, PNLKey>> pnl_source) =>
+         pnl_source
+            // ensure this fires once immediatey, because the known symbols are appended to the first update
+            // (observers shouldn't have to wait for the pnl source to tick to see them).
+            .StartWith(TableUpdate<PNLRowData, PNLKey>.mk_empty(PNLRowData.key_fn))
+            .distinct_on(PNLRowData.key_fn, r => r.symbol, s => s)
+            .Filter(sym => !string.IsNullOrEmpty(sym))
+            .AppendTable(mbts.co2.UserSymbol.get_all().Select(u => u.symbol).Distinct().ToList());
+
       #region Fills Popup Utils
       static void _append_key_filters(fills.FillsFilterStates f, ColumnKeys key) {
          switch (key) {
@@ -734,7 +767,7 @@ namespace bts.shell.pnl {
             }
          }
          foreach (var v in filtered.added) {
-            var r = new PNLRowVM(v.with(calc_type: calculation_type), _default_appearances, _triggers);
+            var r = new PNLRowVM(v.with(calc_type: calculation_type), _default_appearances, _triggers, _fmt_fill_price, _fmt_market_price);
             rows.InsertSorted(r, PNLRowVM.key_comparer);
                total_pnl += r.normalized_data;
          }

src/client/spark/Modules/Trading/PNL/View/PNLRowCollectionView.cs

@@ -112,27 +112,27 @@ namespace bts.shell.pnl {
          });
          // sod
          sod_pnl = _cell_map.add_pnl(ColumnKeys.SODPNL, d => d.sod_pnl);
-         sod_net_pos = _cell_map.add_net_pos(ColumnKeys.SODNetPos, d => d.sod_net_pos);
-         sod_long_pos = _cell_map.add_long_pos(ColumnKeys.SODLongPos, d => d.sod_long_pos);
-         sod_short_pos = _cell_map.add_short_pos(ColumnKeys.SODShortPos, d => d.sod_short_pos);
+         sod_net_pos = _cell_map.add_net_pos(ColumnKeys.SODNetPos, d => d.display_sod_net_pos);
+         sod_long_pos = _cell_map.add_long_pos(ColumnKeys.SODLongPos, d => d.display_sod_long_pos);
+         sod_short_pos = _cell_map.add_short_pos(ColumnKeys.SODShortPos, d => d.display_sod_short_pos);
          // day
          day_pnl = _cell_map.add_pnl(ColumnKeys.DayPNL, d => d.day_pnl);
-         day_net_pos = _cell_map.add_net_pos(ColumnKeys.DayNetPos, d => d.day_net_pos);
-         day_long_pos = _cell_map.add_long_pos(ColumnKeys.DayLongPos, d => d.day_long_pos);
-         day_short_pos = _cell_map.add_short_pos(ColumnKeys.DayShortPos, d => d.day_short_pos);
+         day_net_pos = _cell_map.add_net_pos(ColumnKeys.DayNetPos, d => d.display_day_net_pos);
+         day_long_pos = _cell_map.add_long_pos(ColumnKeys.DayLongPos, d => d.display_day_long_pos);
+         day_short_pos = _cell_map.add_short_pos(ColumnKeys.DayShortPos, d => d.display_day_short_pos);
          // raw day
-         raw_day_net_pos = _cell_map.add_net_pos(ColumnKeys.RawDayNetPos, d => d.raw_day_net_pos);
-         raw_day_long_pos = _cell_map.add_long_pos(ColumnKeys.RawDayLongPos, d => d.raw_day_long_pos);
-         raw_day_short_pos = _cell_map.add_short_pos(ColumnKeys.RawDayShortPos, d => d.raw_day_short_pos);
+         raw_day_net_pos = _cell_map.add_net_pos(ColumnKeys.RawDayNetPos, d => d.display_raw_day_net_pos);
+         raw_day_long_pos = _cell_map.add_long_pos(ColumnKeys.RawDayLongPos, d => d.display_raw_day_long_pos);
+         raw_day_short_pos = _cell_map.add_short_pos(ColumnKeys.RawDayShortPos, d => d.display_raw_day_short_pos);
          // total
          total_pnl = _cell_map.add(ColumnKeys.TotalPNL, d => d.total_pnl, FormattingDelegates.Price<decimal>.Value);
-         total_net_pos = _cell_map.add(ColumnKeys.TotalNetPos, d => d.total_net_pos);
-         total_long_pos = _cell_map.add(ColumnKeys.TotalLongPos, d => d.total_long_pos);
-         total_short_pos = _cell_map.add(ColumnKeys.TotalShortPos, d => d.total_short_pos);
+         total_net_pos = _cell_map.add(ColumnKeys.TotalNetPos, d => d.display_total_net_pos);
+         total_long_pos = _cell_map.add(ColumnKeys.TotalLongPos, d => d.display_total_long_pos);
+         total_short_pos = _cell_map.add(ColumnKeys.TotalShortPos, d => d.display_total_short_pos);
          // working
-         working_net_pos = _cell_map.add(ColumnKeys.WorkingNetPos, d => d.working_net_pos);
-         working_long_pos = _cell_map.add(ColumnKeys.WorkingLongPos, d => d.working_long_pos);
-         working_short_pos = _cell_map.add(ColumnKeys.WorkingShortPos, d => d.working_short_pos);
+         working_net_pos = _cell_map.add(ColumnKeys.WorkingNetPos, d => d.display_working_net_pos);
+         working_long_pos = _cell_map.add(ColumnKeys.WorkingLongPos, d => d.display_working_long_pos);
+         working_short_pos = _cell_map.add(ColumnKeys.WorkingShortPos, d => d.display_working_short_pos);
 
          _cell_map.on_row(data);
          _cell_map.set_appearances(_animator.cell_appearances);

src/client/spark/Modules/Trading/PNL/View/PNLView.xaml

@@ -619,7 +619,7 @@
             <!--Symbol-->
             <pnl:PNLColumn
               c:DataGridFilterProperties.Filter="{Binding DataContext.symbol_filter, Source={u:DirectReference _grid}}"
-              c:DataGridFilterProperties.FilterTemplate="{StaticResource {x:Static ft:DataGridFilterKnownTemplates.DiscreteValues}}"
+              c:DataGridFilterProperties.FilterTemplate="{StaticResource {x:Static ft:DataGridFilterKnownTemplates.DiscreteValuesCollectionView}}"
               c:DataGridFilterProperties.FilterActive="{Binding DataContext.symbol_filter.active, Source={u:DirectReference _grid}}"
               c:DataGridFilterProperties.FilterOpen="{Binding DataContext.symbol_filter.open, Source={u:DirectReference _grid}}"
               key="Symbol"

src/client/spark/Modules/Trading/TradingShellModule.cs

@@ -1,4 +1,5 @@
 using bts.api;
+using bts.api.position;
 using bts.shell.fills;
 using bts.shell.manual_fills;
 using bts.spark;
@@ -38,6 +39,7 @@ namespace bts.shell {
             UserSettingsHub settings_hub, 
             OrdersModel orders_model,
             md.MBOService mbo,
+            IPositionModel position_model,
             ErrorReporter error_reporter) {
          /// Unlike our <see cref="SparkCommand"/> members, <see cref="IShellWindowFactory"/> members must be instantiated immediately,
          /// as they are responsible for launching windows in response to a SparkTag being published to the bus.
@@ -47,7 +49,7 @@ namespace bts.shell {
          _fwf = new FillsWindowFactory(this, bus, settings_hub, orders_model);
          _pnl_conf = new PNLConfig(mbts.config.Configuration.get<bts.config.PNLOptions>());
          if (_pnl_conf.show_new_pnl)
-            _plwf = new PNLWindowFactory(this, bus, settings_hub, orders_model);
+            _plwf = new PNLWindowFactory(this, bus, settings_hub, orders_model, position_model);
          if (_pnl_conf.show_old_pnl)
             _old_plwf = new PAndLWindowFactory(this, bus, settings_hub, orders_model);
          _aswf = new AlgoStudioWindowFactory(this, bus, orders_model, error_reporter);

src/client/spark/Notifications/INotifier.cs

@@ -2,6 +2,7 @@
 using bts.api;
 using bts.shell;
 using bts.spark;
+using bts.utils;
 using mbts.config;
 using mbts.persist;
 using mbts.spark;
@@ -114,6 +115,7 @@ namespace mbts.ui {
             void dispose_core() {
                Disposable.dispose(ref _settings_sub);
                Disposable.dispose(ref _toast_controller);
+               Disposable.dispose(ref _sound_player);
                if (_dispatcher != null && !_dispatcher.HasShutdownStarted) {
                   _dispatcher.BeginInvokeShutdown(DispatcherPriority.Background);
                }
@@ -158,15 +160,25 @@ namespace mbts.ui {
             }
          }
 
-         class SoundNotificationPlayer {
-            readonly IReadOnlyDictionary<SoundNotification.SystemSound, NAudioPlayer> _players;
-
-            public static SoundNotificationPlayer create() => new SoundNotificationPlayer(_all_players());
+         class SoundNotificationPlayer : IDisposable {
+            IReadOnlyDictionary<SoundNotification.SystemSound, NAudioPlayer> _players;
 
             SoundNotificationPlayer(IReadOnlyDictionary<SoundNotification.SystemSound, NAudioPlayer> players) =>
                _players = players;
 
+            public static SoundNotificationPlayer create() =>
+               new SoundNotificationPlayer(_all_players());
+
+            public void Dispose() {
+               if (_players != null) {
+                  _players.Values.DisposeAll();
+                  _players = null;
+               }
+            }
+
             public void play_sounds(IEnumerable<SoundNotification> sounds) {
+               if (_players == null)
+                  return;
                foreach (var s in sounds) {
                   switch (s.sound_type_case) {
                      case SoundNotification.SoundTypeOneofCase.System: _players.GetValueOrDefault(s.system_sound.Value)?.play(); break;
@@ -177,7 +189,8 @@ namespace mbts.ui {
             }
 
             static IReadOnlyDictionary<SoundNotification.SystemSound, NAudioPlayer> _all_players() =>
-               EnumHelper.get_values<SoundNotification.SystemSound>().ToReadOnlyDictionary(s => s, NAudioPlayer.create);
+               EnumHelper.get_values<SoundNotification.SystemSound>()
+               .ToReadOnlyDictionaryWhere<SoundNotification.SystemSound, NAudioPlayer>(NAudioPlayer.try_create);
          }
 
          // This class adopts to role of view-controller in the mvc paradigm, rather than view-model in mvvm.

src/client/spark/Notifications/NAudioPlayer.cs

@@ -1,4 +1,5 @@
-using bts.shell;
+using bts;
+using bts.shell;
 using mbts.ui.utility;
 using NAudio.Wave;
 using System;
@@ -6,29 +7,71 @@ using System.IO;
 using System.Threading.Tasks;
 
 namespace mbts.ui {
-   class NAudioPlayer {
+   class NAudioPlayer : IDisposable {
       // number of milliseconds to delay playing sound,
       // during which time all subsequent requests to play the same sound will be ignored.
       const int _delay_ms = 75;
       readonly int _start_position;
+      IDisposable _stream_in;
       WaveOutEvent _wave_out = new WaveOutEvent();
       WaveFileReader _wave_reader;
       bool _is_playing, _is_play_requested;
 
-      public NAudioPlayer(Stream uwave_stream, int start_position = 0) {
-         var ms = new MemoryStream();
-         uwave_stream.CopyTo(ms);
-         ms.Position = 0;
-         _wave_reader = new WaveFileReader(ms);
+      /// <paramref name="stream_in"/> should not be disposed by the caller,
+      /// as NAudioPlayer handles that in its own Dispose method;
+      /// this constructor is private is to prevent such misuse.
+      NAudioPlayer(Stream stream_in, int start_position = 0) {
+         _stream_in = stream_in;
+         _wave_reader = new WaveFileReader(stream_in);
          _wave_reader.Position = _start_position = (start_position < _wave_reader.Length ? start_position : 0);
          _wave_out.Init(_wave_reader);
          _wave_out.PlaybackStopped += _on_playback_stopped;
       }
 
-      public static NAudioPlayer create(SoundNotification.SystemSound system_sound) {
-         var stream = _get_stream(system_sound);
-         var sb = EnumHelper.get_attribute<SoundNotification.SystemSound, SilenceBufferAttribute>(system_sound);
-         return sb != null ? new NAudioPlayer(stream, sb.start_position) : new NAudioPlayer(stream);
+      /// <see cref="_playback_stopped"/> is a proxy/buffer for the _wave_out.PlaybackStopped event.
+      /// It serves a couple purposes:
+      ///   1) The main callback (<see cref="_on_playback_stopped(object, StoppedEventArgs)"/>)
+      ///      is guarenteed to be executed first (though it would be anyways, since that
+      ///      callback is hooked up in the constructor, the proxy event makes it obvious).
+      ///   2) <see cref="_playback_stopped"/> is only raised after playback is truly complete,
+      ///      meaning there are no pending requests to repeat the sound.
+      event Action _playback_stopped;
+
+      public static bool try_create(SoundNotification.SystemSound system_sound, out NAudioPlayer result) {
+         if (_try_get_stream(system_sound, out var stream)) {
+            var sb = EnumHelper.get_attribute<SoundNotification.SystemSound, SilenceBufferAttribute>(system_sound);
+            result = sb != null ? new NAudioPlayer(stream, sb.start_position) : new NAudioPlayer(stream);
+            return true;
+         }
+         result = null;
+         return false;
+      }
+
+      public static void play(SoundNotification.SystemSound system_sound) {
+         if (try_create(system_sound, out var player)) {
+            try {
+               var temp = player;
+               temp._playback_stopped += temp.Dispose;
+               player.play();
+               player = null;
+            } catch (Exception ex) {
+               Log.Ui.warn($"Encountered exception playing the system sound '{system_sound}': {ex}.");
+            } finally {
+               player?.Dispose();
+            }
+         } else {
+            Log.Ui.warn($"Unable to play the system sound '{system_sound}': unexpected sound type (did not find an audio stream that corresponds to this enum value).");
+         }
+      }
+
+      public void Dispose() {
+         if (_wave_out != null) {
+            _wave_out.PlaybackStopped -= _on_playback_stopped;
+            _wave_out.Dispose();
+            _wave_out = null;
+         }
+         Disposable.dispose(ref _wave_reader);
+         Disposable.dispose(ref _stream_in);
       }
 
       public void play() {
@@ -46,6 +89,8 @@ namespace mbts.ui {
          if (_is_play_requested) {
             _is_play_requested = false;
             _play_core();
+         } else {
+            _playback_stopped?.Invoke();
          }
       }
 
@@ -56,18 +101,26 @@ namespace mbts.ui {
          _is_playing = false;
       }
 
-      static Stream _get_stream(SoundNotification.SystemSound system_sound) {
+      static bool _try_get_stream(SoundNotification.SystemSound system_sound, out Stream stream) {
+         UnmanagedMemoryStream um_stream;
          switch (system_sound) {
-            case SoundNotification.SystemSound.GameCorrect: return bts.Properties.Resources.game_sound_correct;
-            case SoundNotification.SystemSound.GameIncorrect: return bts.Properties.Resources.game_sound_wrong;
-            case SoundNotification.SystemSound.GameOverArcade: return bts.Properties.Resources.game_over_arcade;
-            case SoundNotification.SystemSound.Whistle: return bts.Properties.Resources.whistle;
-            case SoundNotification.SystemSound.BellCounter: return bts.Properties.Resources.bell_counter;
-            case SoundNotification.SystemSound.Powerup: return bts.Properties.Resources.powerup;
-            case SoundNotification.SystemSound.CashRegister: return bts.Properties.Resources.cash_register_purchase;
-            case SoundNotification.SystemSound.Reload: return bts.Properties.Resources.reload_1911;
-            default: throw new NotImplementedException($"Unknown {nameof(SoundNotification.SystemSound)}: {system_sound}.");
+            case SoundNotification.SystemSound.GameCorrect: um_stream = bts.Properties.Resources.game_sound_correct; break;
+            case SoundNotification.SystemSound.GameIncorrect: um_stream = bts.Properties.Resources.game_sound_wrong; break;
+            case SoundNotification.SystemSound.GameOverArcade: um_stream = bts.Properties.Resources.game_over_arcade; break;
+            case SoundNotification.SystemSound.Whistle: um_stream = bts.Properties.Resources.whistle; break;
+            case SoundNotification.SystemSound.BellCounter: um_stream = bts.Properties.Resources.bell_counter; break;
+            case SoundNotification.SystemSound.Powerup: um_stream = bts.Properties.Resources.powerup; break;
+            case SoundNotification.SystemSound.CashRegister: um_stream = bts.Properties.Resources.cash_register_purchase; break;
+            case SoundNotification.SystemSound.Reload: um_stream = bts.Properties.Resources.reload_1911; break;
+            default:
+               stream = null;
+               return false;
          }
+         stream = new MemoryStream();
+         um_stream.CopyTo(stream);
+         um_stream.Dispose();
+         stream.Position = 0;
+         return true;
       }
    }
-}
+}

src/client/spark/Orders/AlgoParamVM.cs

@@ -10,6 +10,7 @@ namespace mbts.spark {
    class AlgoParamVM<T> : IAlgoParamVM<T>, INotifyPropertyChanged, ITemplateSelectorKey {
       readonly IEqualityComparer<T> _comparer;
       readonly string _template_key;
+      readonly Func<T, T> _to_display_value, _from_display_value;
       AlgoParamPermissions _permissions;
       bool _is_enabled, _has_value;
       T _committed_value, _value;
@@ -20,13 +21,15 @@ namespace mbts.spark {
       public AlgoParamVM(string id, string display_name, T value, string template_key = null)
          : this(id, display_name, value, EqualityComparer<T>.Default, template_key) { }
 
-      public AlgoParamVM(string id, string display_name, T value, IEqualityComparer<T> comparer, string template_key = null) {
+      public AlgoParamVM(string id, string display_name, T value, IEqualityComparer<T> comparer, string template_key = null, Func<T, T> to_display_value = null, Func<T, T> from_display_value = null) {
          this.id = id;
          this.display_name = display_name;
          _value = value;
          _committed_value = value;
          _comparer = comparer;
          _template_key = template_key;
+         _to_display_value = to_display_value;
+         _from_display_value = from_display_value;
       }
 
       public event PropertyChangedEventHandler PropertyChanged;
@@ -43,6 +46,10 @@ namespace mbts.spark {
                _toggle_is_dirty();
          }
       }
+      public T display_value {
+         get => _to_display_value == null ? value : _to_display_value(value);
+         set => this.value = _from_display_value == null ? value : _from_display_value(value);
+      }
       public AlgoParamPermissions permissions {
          get => _permissions;
          set {
@@ -54,6 +61,7 @@ namespace mbts.spark {
       public bool has_value { get => _has_value; set => _set(ref _has_value, value); }
       public bool is_dirty { get; private set; }
       object IAlgoParamVM.value { get => value; set => this.value = (T)value; }
+      object IAlgoParamVM.display_value { get => display_value; set => display_value = (T)value; }
 
       string ITemplateSelectorKey.key => _template_key;
 
@@ -64,6 +72,9 @@ namespace mbts.spark {
          }
       }
 
+      public void refresh_display_value() =>
+         PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(display_value)));
+
       public IObservable<T> subscribe_value() {
          return Observable.Create<T>(o => {
             o.OnNext(_value);
@@ -113,6 +124,7 @@ namespace mbts.spark {
             value_changed(_value, _value = new_value);
          }
          PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(value)));
+         PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(display_value)));
       }
 
       void _toggle_is_dirty() {

src/client/spark/Orders/ExistingOrderTicketVM.cs

@@ -18,6 +18,7 @@ namespace mbts.spark {
       readonly Property<TimeInForce> _current_time_in_force;
       readonly Property<CustomOrderDefinition.CustomOneofCase> _current_order_type;
       readonly Property<bool> _price_dirty, _size_dirty, _account_dirty, _time_in_force_dirty, _order_type_dirty;
+      uint _display_quantity_divisor = 1;
 
       public ExistingOrderTicketVM(OrdersModel model, IObservable<(SecurityMD? security_md, OrderRecordImmutable order)> order_source, IObservable<int[]> calculator_buttons) {
          uint? key = null;
@@ -40,7 +41,7 @@ namespace mbts.spark {
             (val, curr) => !double.IsNaN(val) && val != curr));
          _size_dirty = backing(
             nameof(size_dirty),
-            size_calculator.observe_current(true)
+            size_calculator.observe_actual_value()
             .CombineLatest(_current_size.observe_current(true),
             (val, curr) => val.HasValue && val.Value != curr));
          _account_dirty = backing(
@@ -83,14 +84,17 @@ namespace mbts.spark {
          _dispose = Disposable.Create(
             size_calculator,
             properties_vm,
-            security_md_source.OnDispatcher().Subscribe(smd => bbo.security_md = smd),
+            security_md_source.OnDispatcher().Subscribe(smd => {
+               bbo.security_md = smd;
+               display_quantity_divisor = model.security_auxiliary_model.get_display_quantity_divisor(smd.security);
+            }),
             bbo,
             order_source.OnDispatcher().Subscribe(ort => {
                key = ort.order.Key;
                if (DoubleHelper.IsNaNOrInfinity(price))
                   price = ort.order.State.Price;
                if (!size_calculator.value.HasValue || !size_calculator.value_setter_called)
-                  size_calculator.bypass_value_setter(ort.order.State.Quantity);
+                  size_calculator.bypass_value_setter(ort.order.State.Quantity, true);
             }),
             Observable.Merge(_price_dirty, _size_dirty, _account_dirty, _time_in_force_dirty, _order_type_dirty).OnDispatcher().Subscribe(_ => RaisePropertyChanged(nameof(dirty_items_text))),
             _price_dirty.observe_current(true).CombineLatest(_size_dirty.observe_current(true), (pd, sd) => pd || sd).DistinctUntilChanged().OnDispatcher().Subscribe(modify_order));
@@ -104,6 +108,13 @@ namespace mbts.spark {
       public OrderPropertiesEditorVM properties_vm { get; }
       public double price { get => _price.Value; set => _price.Value = value; }
       public CalculatorLogic size_calculator { get; }
+      public uint display_quantity_divisor {
+         get => _display_quantity_divisor;
+         private set {
+            Set(ref _display_quantity_divisor, value);
+            size_calculator.display_divisor = value;
+         }
+      }
       public double current_price => _current_price.Value;
       public uint current_size => _current_size.Value;
       public AccountTuple current_account => _current_account.Value;
@@ -137,4 +148,4 @@ namespace mbts.spark {
          if (_order_type_dirty.Value) yield return "type";
       }
    }
-}
+}

src/client/spark/Orders/NewOrderTicketVM.cs

@@ -31,6 +31,7 @@ namespace mbts.spark {
 
    class NewOrderTicketVM : DisposableViewModelBase, IRequestViewClose {
       readonly Property<SecurityImmutable> _security;
+      uint _display_quantity_divisor = 1;
 
       public NewOrderTicketVM(OrdersModel model, SecurityMD security_md, OrderDefinitionImmutable def, double price, uint size, IObservable<int[]> calculator_buttons)
          : this(model, Observable.Return(security_md), Observable.Return(new InlineOrderTicketProperties(model, def, price, size)), calculator_buttons) { }
@@ -61,7 +62,10 @@ namespace mbts.spark {
          set_price_command = new DelegateCommand<double>(set_price);
          _dispose = Disposable.Create(
             bbo,
-            security_md_source.OnDispatcher().Subscribe(smd => bbo.security_md = smd),
+            security_md_source.OnDispatcher().Subscribe(smd => {
+               bbo.security_md = smd;
+               display_quantity_divisor = model.security_auxiliary_model.get_display_quantity_divisor(smd.security);
+            }),
             size_calculator = new CalculatorLogic(0, calculator_buttons),
             props_source.OnDispatcher().Subscribe(p => on_props(p.price, p.size))
          );
@@ -83,6 +87,13 @@ namespace mbts.spark {
       public SecurityImmutable security => _security.Value;
       public double price { get; set; }
       public CalculatorLogic size_calculator { get; }
+      public uint display_quantity_divisor {
+         get => _display_quantity_divisor;
+         private set {
+            Set(ref _display_quantity_divisor, value);
+            size_calculator.display_divisor = value;
+         }
+      }
       public OrderPropertiesEditorVM properties_vm { get; }
       public BBOVM bbo { get; }
       public bool close_on_send { get; set; }

src/client/spark/Orders/OrderModificationControl.xaml

@@ -85,7 +85,7 @@
         usp:OrderModificationControl.IsDirty="{Binding size_dirty, FallbackValue={x:Null}}"
         CommitOnEnter="True"
         Focusable="False"
-        Value="{Binding size_calculator.value}"
+        Value="{Binding size_calculator.display_value}"
       />
     </Grid>
     <Grid Grid.Column="2">
@@ -114,15 +114,26 @@
         <ColumnDefinition/>
       </Grid.ColumnDefinitions>
       <Button
-        Content="{Binding bbo.bid_size}" Command="{Binding size_calculator.set_value_command}"
-        CommandParameter="{Binding bbo.bid_size}" Foreground="{u:BTSColor MarketData.bid}"
-      />
+        Command="{Binding size_calculator.set_actual_value_command}"
+        CommandParameter="{Binding bbo.bid_size}"
+        Foreground="{u:BTSColor MarketData.bid}"
+      >
+        <MultiBinding Converter="{x:Static cv:DynamicDoubleDivisorConverter.Instance}">
+          <Binding Path="bbo.bid_size"/>
+          <Binding Path="display_quantity_divisor"/>
+        </MultiBinding>
+      </Button>
       <Button
         Grid.Column="2"
-        Content="{Binding bbo.ask_size}" Command="{Binding size_calculator.set_value_command}"
+        Command="{Binding size_calculator.set_actual_value_command}"
         CommandParameter="{Binding bbo.ask_size}"
         Foreground="{u:BTSColor MarketData.ask}"
-      />
+      >
+        <MultiBinding Converter="{x:Static cv:DynamicDoubleDivisorConverter.Instance}">
+          <Binding Path="bbo.ask_size"/>
+          <Binding Path="display_quantity_divisor"/>
+        </MultiBinding>
+      </Button>
     </Grid>
     <Grid Grid.Row="4" Grid.RowSpan="3">
       <Grid.RowDefinitions>
@@ -139,9 +150,18 @@
         <ItemsControl.ItemTemplate>
           <DataTemplate>
             <Button
-              Margin="2,4,2,0" Content="{Binding}" Focusable="False" CommandParameter="{Binding}"
+              Margin="2,4,2,0"
+              Content="{Binding}"
+              Focusable="False"
               Command="{Binding Path=DataContext.click, RelativeSource={RelativeSource AncestorType=ItemsControl}}"
-            />
+            >
+              <Button.CommandParameter>
+                <MultiBinding Converter="{x:Static cv:DynamicDoubleMultiplierConverter.Instance}">
+                  <Binding/>
+                  <Binding Path="DataContext.display_quantity_divisor" RelativeSource="{RelativeSource AncestorType=usp:OrderModificationControl}"/>
+                </MultiBinding>
+              </Button.CommandParameter>
+            </Button>
           </DataTemplate>
         </ItemsControl.ItemTemplate>
       </ItemsControl>

src/client/spark/Orders/OrderTicket.xaml

@@ -1,13 +1,16 @@
-<Window x:Class="mbts.ui.spark.OrderTicket"
-        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
-        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
-        xmlns:msys="clr-namespace:bts.api;assembly=spark_api"
-        xmlns:u="clr-namespace:mbts.ui"
-        xmlns:usp="clr-namespace:mbts.ui.spark"
-        xmlns:sys="clr-namespace:System;assembly=mscorlib"
-        u:WindowStyle.SizeToContent="WidthAndHeight"
-        u:WindowStyle.TitleContent="{Binding bbo, Mode=OneWay}"
-        Style="{StaticResource BTSWindowTitleTemplate}">
+<Window
+  x:Class="mbts.ui.spark.OrderTicket"
+  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+  xmlns:msys="clr-namespace:bts.api;assembly=spark_api"
+  xmlns:u="clr-namespace:mbts.ui"
+  xmlns:cv="clr-namespace:mbts.ui.converters"
+  xmlns:usp="clr-namespace:mbts.ui.spark"
+  xmlns:sys="clr-namespace:System;assembly=mscorlib"
+  u:WindowStyle.SizeToContent="WidthAndHeight"
+  u:WindowStyle.TitleContent="{Binding bbo, Mode=OneWay}"
+  Style="{StaticResource BTSWindowTitleTemplate}"
+>
   <Window.Resources>
     <ResourceDictionary>
       <ResourceDictionary.MergedDictionaries>
@@ -123,7 +126,12 @@
       <TextBlock>
         <TextBlock.Inlines>
           <Run Text="{Binding security, Mode=OneWay}" FontWeight="Bold"/>
-          <Run Foreground="{u:BTSColor MarketData.bid}" FontSize="10" Text="{Binding bid_size, Mode=OneWay, StringFormat='{}({0})'}"/>
+          <Run Foreground="{u:BTSColor MarketData.bid}" FontSize="10">
+            <MultiBinding Converter="{x:Static cv:DynamicDoubleDivisorConverter.Instance}" Mode="OneWay" StringFormat="({0})">
+              <Binding Path="bid_size" Mode="OneWay"/>
+              <Binding Path="DataContext.display_quantity_divisor" RelativeSource="{RelativeSource AncestorType=usp:OrderTicket}"/>
+            </MultiBinding>
+          </Run>
           <Run Foreground="{u:BTSColor MarketData.bid}" FontWeight="Bold">
             <Run.Text>
               <MultiBinding Converter="{StaticResource TickDisplayConverter}" Mode="OneWay">
@@ -140,7 +148,12 @@
               </MultiBinding>
             </Run.Text>
           </Run>
-          <Run Foreground="{u:BTSColor MarketData.ask}" FontSize="10" Text="{Binding ask_size, Mode=OneWay, StringFormat='{}({0})'}"/>
+          <Run Foreground="{u:BTSColor MarketData.ask}" FontSize="10">
+            <MultiBinding Converter="{x:Static cv:DynamicDoubleDivisorConverter.Instance}" Mode="OneWay" StringFormat="({0})">
+              <Binding Path="ask_size" Mode="OneWay"/>
+              <Binding Path="DataContext.display_quantity_divisor" RelativeSource="{RelativeSource AncestorType=usp:OrderTicket}"/>
+            </MultiBinding>
+          </Run>
         </TextBlock.Inlines>
       </TextBlock>
     </DataTemplate>

src/client/spark/Orders/OrderTypeVMs/DynamicOrderHelper.cs

@@ -23,6 +23,32 @@ namespace mbts.spark {
 
       public IEnumerable<string> dynamic_types => _dynamic_types.DynamicOrderDesc.Select(d => d.DynamicOrderType);
 
+      public static string fmt_param(DynamicOrderParam dyn_param) {
+         if (dyn_param == null)
+            return null;
+         switch (dyn_param.ValueCase) {
+            case DynamicOrderParam.ValueOneofCase.AsArray:
+               return string.Join(", ", dyn_param.AsArray.Element.Select(fmt_param));
+            case DynamicOrderParam.ValueOneofCase.AsBool:
+               return dyn_param.AsBool.ToString();
+            case DynamicOrderParam.ValueOneofCase.AsDouble:
+               return dyn_param.AsDouble.ToString();
+            case DynamicOrderParam.ValueOneofCase.AsEnumerated:
+               return dyn_param.AsEnumerated.EnumValue;
+            case DynamicOrderParam.ValueOneofCase.AsInt32:
+               return dyn_param.AsInt32.ToString();
+            case DynamicOrderParam.ValueOneofCase.AsQuantity:
+               return dyn_param.AsQuantity.ToString();
+            case DynamicOrderParam.ValueOneofCase.AsString:
+               return dyn_param.AsString;
+            default:
+               // implement additional cases as needed
+               // (as of 4/17/20, this method is only used to format
+               // dynamic orders' CustomState params in the orderbook)
+               return $"({dyn_param.ValueCase})";
+         }
+      }
+
       public void add_dynamic_order_defs(List<CustomOrderDefinitionImmutable> defs, Func<CustomOrderDefinition.CustomOneofCase, CustomOrderDefinition> factory) {
          foreach (var d in _dynamic_types.DynamicOrderDesc) {
             var dorder = factory(CustomOrderDefinition.CustomOneofCase.Dynamic);

src/client/spark/Orders/OrderTypeVMs/GenericOrderHelper.cs

@@ -33,7 +33,7 @@ namespace mbts.spark
          {
             return;
          } 
-         var ev = fd.EnumType.Values.First(x => x.Name == value)?.Number;
+         var ev = fd.EnumType.Values.FirstOrDefault(x => x.Name == value)?.Number;
          if(ev.HasValue)
             fd.Accessor.SetValue(message, ev.Value);
       }

src/client/spark/Orders/OrderTypeVMs/GenericOrderVM.cs

@@ -2,7 +2,6 @@
 using bts.api;
 using bts.api.orderman;
 using bts.collections;
-using bts.spark;
 using Google.Protobuf;
 using Google.Protobuf.Reflection;
 using mbts.collections;
@@ -15,21 +14,19 @@ using System.Collections.ObjectModel;
 using System.ComponentModel;
 using System.Linq;
 using System.Reactive.Linq;
+using System.Reflection;
 using AlgoType = bts.api.orderman.CustomOrderDefinition.CustomOneofCase;
 
 namespace mbts.spark {
-   static partial class OrderTypeVMFactory 
-   {
-      internal class GenericOrderFactory
-      {
-         static public IAlgoVM create_vm(AlgoKey key, AlgoType algo_type, string display_name, AlgoEditingPermissions editing_permissions)
-         {
+   static partial class OrderTypeVMFactory {
+      internal class GenericOrderFactory {
+         static public IAlgoVM create_vm(AlgoKey key, AlgoType algo_type, string display_name, AlgoEditingPermissions editing_permissions) {
             var prop = typeof(CustomOrderDefinition).GetProperty(algo_type.ToString(),
-               System.Reflection.BindingFlags.Instance | System.Reflection.BindingFlags.Public);
+               BindingFlags.Instance | BindingFlags.Public);
             var rt = prop.PropertyType;
 
             var propi = typeof(CustomOrderDefinitionImmutable).GetProperty(algo_type.ToString(),
-               System.Reflection.BindingFlags.Instance | System.Reflection.BindingFlags.Public);
+               BindingFlags.Instance | BindingFlags.Public);
             var rti = propi.PropertyType;
 
             var vmt = typeof(GenericOrderVM<,>);
@@ -38,38 +35,33 @@ namespace mbts.spark {
             object vm = Activator.CreateInstance(makevm, key, algo_type, display_name, editing_permissions);
             return (IAlgoVM)vm;
          }
-         static public void setup_generic_custom_order(CustomOrderDefinition custom, CustomOrderDefinition.CustomOneofCase type)
-         {
+         static public void setup_generic_custom_order(CustomOrderDefinition custom, CustomOrderDefinition.CustomOneofCase type) {
             var prop = typeof(CustomOrderDefinition).GetProperty(type.ToString(),
-               System.Reflection.BindingFlags.Instance | System.Reflection.BindingFlags.Public);
+               BindingFlags.Instance | BindingFlags.Public);
             var rt = prop.PropertyType;
             var rtt = Activator.CreateInstance(rt);
-            
+
             var ci = rt.GetProperties().Where(x => x.PropertyType == typeof(CustomOrderDefinition));
-            foreach(var cid in ci)
+            foreach (var cid in ci)
                cid.SetValue(rtt, new CustomOrderDefinition { Limit = new LimitOrderDefinition() });
             prop.SetValue(custom, rtt);
          }
-      }      
-      
+      }
+
       class GenericOrderVM<TMutable, TImmutable> : OrderTypeVMBase<TMutable, TImmutable>
-         where TMutable : class, IMessage, new() where TImmutable : struct, IImmutableMessage
-      {         
+         where TMutable : class, IMessage, new() where TImmutable : struct, IImmutableMessage {
          readonly ObservableKeyedCollection<GenericOrderParamVM<TMutable>, string> _parameters =
             new ObservableKeyedCollection<GenericOrderParamVM<TMutable>, string>(vm => vm.descriptor.Name);
          readonly AlgoType _algo_type;
 
          public GenericOrderVM(AlgoKey key, AlgoType algo_type, string display_name, AlgoEditingPermissions editing_permissions)
-            : base(key, display_name, editing_permissions) 
-         {
+            : base(key, display_name, editing_permissions) {
             _algo_type = algo_type;
             _parameters = new ObservableKeyedCollection<GenericOrderParamVM<TMutable>, string>(vm => vm.descriptor.Name);
             _resources.AddRange(
-               ObservableAutoWrapper.connect_item_hooks(_parameters, p =>
-               {
+               ObservableAutoWrapper.connect_item_hooks(_parameters, p => {
                   p.PropertyChanged += on_param_prop_changed;
-                  return Disposable.Create(() => 
-                  {
+                  return Disposable.Create(() => {
                      p.PropertyChanged -= on_param_prop_changed;
                      remove_property(p.descriptor.Name);
                      p.Dispose();
@@ -80,84 +72,74 @@ namespace mbts.spark {
          }
 
          public string algo_type => _algo_type.ToString();
-         public override string abbreviation => 
+         public override string abbreviation =>
             model == null ? display_name : model.factory.abbreviate_algo(new OneOf<CustomOrderDefinition.CustomOneofCase, string>(_algo_type));
          public override AlgoDisplayGroup group => AlgoDisplayGroup.API;
          public ObservableCollection<GenericOrderParamVM<TMutable>> parameters => _parameters;
 
-         protected override void on_model_internal() 
-         {
+         protected override void on_model_internal() =>
             _sync_generic_params();
-         }
 
-         void _sync_generic_params()
-         {
-            if (model != null)
-            {               
-               Google.Protobuf.Reflection.MessageDescriptor desc = new TMutable().Descriptor;               
+         void _sync_generic_params() {
+            if (model != null) {
+               MessageDescriptor desc = new TMutable().Descriptor;
                _parameters.SyncWithDictionary(
                   desc.Fields.InDeclarationOrder().Where(_is_value_param_desc).ToDictionary(p => p.Name), _mk_param_vm);
             }
          }
-         static bool _is_value_param_desc(FieldDescriptor desc)
-         {
-            return (desc.FieldType != Google.Protobuf.Reflection.FieldType.Message || 
+
+         static bool _is_value_param_desc(FieldDescriptor desc) =>
+            (desc.FieldType != FieldType.Message ||
                _is_quantity_measure_desc(desc));
-         }
 
-         static bool _is_quantity_measure_desc(FieldDescriptor desc)
-         {
-            return desc.FieldType == Google.Protobuf.Reflection.FieldType.Message &&
+         static bool _is_quantity_measure_desc(FieldDescriptor desc) =>
+            desc.FieldType == FieldType.Message &&
                desc.MessageType.FullName == typeof(bts.spark.QuantityMeasure).FullName;
-         }
 
-         protected override IEnumerable<ChildAlgoData> get_selector_data() 
-         {
-            var v = OrderDataHelper.get_child_algo_data(_algo_type);
-            return v;
-         }
+         protected override IEnumerable<ChildAlgoData> get_selector_data() =>
+            OrderDataHelper.get_child_algo_data(_algo_type);
 
-         GenericOrderParamVM<TMutable> _mk_param_vm(FieldDescriptor descriptor) 
-         {
+         GenericOrderParamVM<TMutable> _mk_param_vm(FieldDescriptor descriptor) {
             ExceptionAssert.Argument.NotNull(descriptor, nameof(descriptor));
-
-            if (descriptor.FieldType == FieldType.Message && 
-                descriptor.MessageType.FullName == typeof(bts.spark.QuantityMeasure).FullName)
-            {
+            if (descriptor.FieldType == FieldType.Message &&
+                descriptor.MessageType.FullName == typeof(bts.spark.QuantityMeasure).FullName) {
                var qm = new GenericOrderQuantityVM<TMutable>(descriptor);
                return attached(qm, GenericOrderHelper.get_quantity_value, GenericOrderHelper.set_quantity_value);
-            }
-            else if(descriptor.FieldType == FieldType.Enum)
-            {
-               var pvm = new GenericOrderEnumeratedVM<TMutable>(descriptor);
-               attached(pvm, GenericOrderHelper.get_enumerated_value, GenericOrderHelper.set_enumerated_value);
-               return pvm;
-            }
-            else if (descriptor.FieldType == FieldType.Bool)
+            } else if (descriptor.FieldType == FieldType.Enum) {
+               return EnumParamFactory.create(this, descriptor);
+            } else if (descriptor.FieldType == FieldType.Bool) {
                return mk<bool?, bool>(descriptor, v => v, v => v.GetValueOrDefault());
-            else if (descriptor.FieldType == FieldType.Double || descriptor.FieldType == FieldType.Float)
+            } else if (descriptor.FieldType == FieldType.Double || descriptor.FieldType == FieldType.Float) {
                return mk<double, double>(descriptor, v => v, v => v, double.NaN);
-            else if (descriptor.FieldType == FieldType.Int32)
+            } else if (descriptor.FieldType == FieldType.Int32) {
                return mk<int?, int>(descriptor, v => v, v => v.GetValueOrDefault());
-            else if (descriptor.FieldType == FieldType.UInt32)
+            } else if (descriptor.FieldType == FieldType.UInt32) {
                return mk<uint?, uint>(descriptor, v => v, v => v.GetValueOrDefault());
-            else if (descriptor.FieldType == FieldType.String)
+            } else if (descriptor.FieldType == FieldType.String) {
                return mk<string, string>(descriptor, v => v, v => v);
-            else
-               return null;
+            } else return null;
          }
-         GenericOrderParamVM<TMutable, TView, TModel> mk<TView, TModel>(FieldDescriptor fdesc, Func<TModel, TView> convert, Func<TView, TModel> convert_back, TView default_value = default)
-         {
-            var pvm = new GenericOrderParamVM<TMutable, TView, TModel>(fdesc, convert, convert_back);
-            return attached<TView, GenericOrderParamVM<TMutable, TView, TModel>>(pvm, get_from_param, assign_to_param, default_value);
 
+         GenericOrderParamVM<TMutable, TView, TModel> mk<TView, TModel>(
+            FieldDescriptor fdesc,
+            Func<TModel, TView> convert,
+            Func<TView, TModel> convert_back,
+            TView default_value = default) {
+            //
+            var pvm = new GenericOrderParamVM<TMutable, TView, TModel>(fdesc, convert, convert_back);
+            return attached(pvm, get_from_param, assign_to_param, default_value);
             TView get_from_param(IMessage param, FieldDescriptor fd) => convert(ConvertUtils.try_convert<TModel>(fdesc.Accessor.GetValue(param)));
             void assign_to_param(IMessage param, FieldDescriptor fd, TView value) => fdesc.Accessor.SetValue(param, convert_back(value));
          }
 
-         TParam attached<T, TParam>(TParam pvm, Func<IMessage, FieldDescriptor, T> selector, Action<IMessage, FieldDescriptor, T> assign_to_param, T default_value = default) where TParam : GenericOrderParamVM<TMutable>, IGenericOrderParamVM<T>
-         {
-            add_property<T>(
+         TParam attached<T, TParam>(
+            TParam pvm,
+            Func<IMessage, FieldDescriptor, T>
+            selector, Action<IMessage, FieldDescriptor, T> assign_to_param,
+            T default_value = default)
+            where TParam : GenericOrderParamVM<TMutable>, IGenericOrderParamVM<T> {
+            //
+            add_property(
                pvm.descriptor.Name,
                mdef => mdef != null ? selector(mdef, pvm.descriptor) : default_value,
                (mdef, v) => assign_to_param(mdef, pvm.descriptor, v),
@@ -166,7 +148,37 @@ namespace mbts.spark {
                pvm.subscribe_value(),
                default_value);
             return pvm;
-         }         
+         }
+
+         static class EnumParamFactory {
+            [ThreadStatic]
+            static Dictionary<Type, IFactory> _factories_backing;
+            static Dictionary<Type, IFactory> _factories =>
+               _factories_backing ?? (_factories_backing = new Dictionary<Type, IFactory>());
+
+            public static GenericOrderParamVM<TMutable> create(GenericOrderVM<TMutable, TImmutable> owner, FieldDescriptor descriptor) {
+               if (descriptor.FieldType != FieldType.Enum)
+                  throw ExceptionBuilder.Argument.unexpected_case(descriptor.FieldType, $"{nameof(descriptor)}.{nameof(FieldDescriptor.FieldType)}");
+               if (!_factories.TryGetValue(descriptor.EnumType.ClrType, out var f)) {
+                  // Impl<T> is a nested type, so parent class's generic type args must be included.
+                  _factories[descriptor.EnumType.ClrType] = f = (IFactory)Activator.CreateInstance(typeof(Impl<>)
+                     .MakeGenericType(typeof(TMutable), typeof(TImmutable), descriptor.EnumType.ClrType));
+               }
+               return f.create(owner, descriptor);
+            }
+
+            interface IFactory {
+               GenericOrderParamVM<TMutable> create(GenericOrderVM<TMutable, TImmutable> owner, FieldDescriptor descriptor);
+            }
+
+            class Impl<T> : IFactory where T : struct {
+               static readonly Func<T, T?> _convert = v => v;
+               static readonly Func<T?, T> _convert_back = v => v ?? default;
+
+               public GenericOrderParamVM<TMutable> create(GenericOrderVM<TMutable, TImmutable> owner, FieldDescriptor descriptor) =>
+                  owner.mk(descriptor, _convert, _convert_back, default);
+            }
+         }
       }
    }
-}
+}

src/client/spark/Orders/OrderTypeVMs/IOrderTypeVM.cs

@@ -70,6 +70,7 @@ namespace mbts.spark {
       string id { get; }
       string display_name { get; }
       object value { get; set; }
+      object display_value { get; set; }
       bool is_enabled { get; set; }
       bool is_dirty { get; }
       bool has_value { get; }
@@ -81,6 +82,7 @@ namespace mbts.spark {
    interface IAlgoParamVM<T> : IAlgoParamVM {
       event PropertyChange<T> value_changed;
       new T value { get; set; }
+      new T display_value { get; set; }
    }
 
    interface IAlgoSelector : IAlgoParamVM<IAlgoVM>, IObserver<(IReadOnlyDictionary<AlgoKey, AlgoData> algo_data, AlgoKey? default_algo)> {

src/client/spark/Orders/OrderTypeVMs/OrderTypeVMFactory.cs

@@ -985,8 +985,10 @@ namespace mbts.spark {
 
          #region IAlgoParamVM
          IAlgoVM IAlgoParamVM<IAlgoVM>.value { get => selected_algo; set => selected_algo = value; }
+         IAlgoVM IAlgoParamVM<IAlgoVM>.display_value { get => selected_algo; set => selected_algo = value; }
          event PropertyChange<IAlgoVM> IAlgoParamVM<IAlgoVM>.value_changed { add => selected_algo_changed += value; remove => selected_algo_changed -= value; }
          object IAlgoParamVM.value { get => selected_algo; set => selected_algo = (IAlgoVM)value; }
+         object IAlgoParamVM.display_value { get => selected_algo; set => selected_algo = (IAlgoVM)value; }
          bool IAlgoParamVM.has_value => _algo != null;
          // changing child algos is not allowed, so an algo selector is never dirty
          bool IAlgoParamVM.is_dirty => false;

src/client/spark/Orders/OrderUtils.cs

@@ -63,6 +63,11 @@ namespace mbts.spark {
       public static string last_msg(this OrderRecordImmutable order) =>
          order.HasState ? order.State.LastMsg : string.Empty;
 
+      public static IReadOnlyDictionary<string, DynamicOrderParam> dynamic_custom_state(this OrderRecordImmutable order) =>
+         order.HasState && order.State.HasDynamic ?
+            (order.State.Dynamic.CustomState ?? DictionaryHelper.empty<string, DynamicOrderParam>()) :
+            DictionaryHelper.empty<string, DynamicOrderParam>();
+
       public static DateTime created(this OrderRecordImmutable order) =>
          order.HasState && order.State.HasCreated ? order.State.Created.ToDateTime().ToLocalTime() : DateTime.MinValue;
 
@@ -235,8 +240,8 @@ namespace mbts.spark {
       public static string price_quantity_description(double price, uint quantity, ContractSpecificationImmutable spec) =>
          new StringBuilderEx(quantity.ToString(), " @ ", spec.format(price) ?? price.ToString("#0.00##")).ToString();
 
-      public static string filled_status_description(this OrderRecordImmutable order, ContractSpecificationImmutable spec) {
-         var sb = new StringBuilderEx("filled ", order.filled().ToString());
+      public static string filled_status_description(this OrderRecordImmutable order, ContractSpecificationImmutable spec, uint display_qty_divisor = 1) {
+         var sb = new StringBuilderEx("filled ", order.filled().safe_divide(display_qty_divisor).ToString());
          if (order.filled() > 0)
             sb.Add(" @ ", spec.format(order.avg_price()));
          sb.Add(", ", camel_to_title_case(order.status().ToString(), TextCapitalizationFormat.NoCaps));

src/client/spark/Orders/OrdersModel.cs

@@ -10,6 +10,7 @@ using bts.spark;
 using bts.utils;
 using mbts.config;
 using mbts.spark.utilities;
+using mbts.ui;
 using mbts.utils;
 using System;
 using System.Collections.Generic;
@@ -26,8 +27,9 @@ using OrderUpdatePiq = bts.api.core.TableUpdate<bts.api.orderman.OrderSecurity,
 namespace mbts.spark {
    [Export]
    class OrdersModel : IDisposable {
-      public readonly MarketDataAuxiliaryModel md_auxiliary_model;
       public static readonly bool piq_enabled = Configuration.get<bts.config.toggles.PlacementInQueue>().enabled;
+      public readonly MarketDataAuxiliaryModel md_auxiliary_model;
+      public readonly ISecurityAuxiliaryDataModel security_auxiliary_model;
 
       readonly IBus _bus;
       readonly OrderFactory _factory;
@@ -44,8 +46,20 @@ namespace mbts.spark {
       IDisposable _dispose;
 
       [ImportingConstructor]
-      OrdersModel(IBus bus, OrderFactory factory, OrderService service, PositionService position_service, MBOService mbo_service,
-         SpreaderModel spreader, DynamicOrderHelper dynamic_helper, AdminModel admin_model, IAlgoStudioModel algo_model, MarketDataAuxiliaryModel md_auxiliary_model, SecurityStore sstore, ErrorReporter error) {
+      OrdersModel(IBus bus,
+         OrderFactory factory,
+         OrderService service,
+         PositionService position_service,
+         MBOService mbo_service,
+         SpreaderModel spreader,
+         DynamicOrderHelper dynamic_helper,
+         AdminModel admin_model,
+         IAlgoStudioModel algo_model,
+         ISecurityAuxiliaryDataModel security_auxiliary_model,
+         MarketDataAuxiliaryModel md_auxiliary_model,
+         SecurityStore sstore,
+         ErrorReporter error) {
+         //
          _bus = bus;
          _factory = factory;
          _service = service;
@@ -57,6 +71,7 @@ namespace mbts.spark {
          this.admin_model = admin_model;
          this.algo_model = algo_model;
          this.md_auxiliary_model = md_auxiliary_model;
+         this.security_auxiliary_model = security_auxiliary_model;
          var scheduler = ThreadPoolScheduler.Instance;
          var interval = TimeSpan.FromMilliseconds(100);
          on_orders = admin_model
@@ -80,7 +95,10 @@ namespace mbts.spark {
                _position_service.subscribei_pnl_data().Naggle(interval, scheduler),
                p => p.Pos.AccountId)
             .join(sstore, p => p.Pos.SecurityId)
-            .TableCheckedAutoCorrect(EqualityComparer<(SecurityImmutable? sec, PNLUnitImmutable data)>.Default)
+            .Select(
+               tup => (tup.sec, tup.val, new QuantityConversionData(security_auxiliary_model.get_display_quantity_divisor(tup.sec), QuantityConversionData.OpType.DivideActual)),
+               tup => tup.val.RecordId)
+            .TableCheckedAutoCorrect(EqualityComparer<(SecurityImmutable?, PNLUnitImmutable, QuantityConversionData)>.Default)
             .Where(t => t.has_changes())
             .Cache();
          var working_orders = on_orders.Filter(tup => tup.order.is_active());
@@ -167,8 +185,8 @@ namespace mbts.spark {
                working_account_order_groups,
                PNLRowData.key_fn,
                acc_orders => acc_orders.group_key,
-               (pnl_row_data, acc_orders, pnl_key) => pnl_row_data.with(working: WorkingOrderData.Create(acc_orders.table.state.Values.Select(t => t.order))),
-               (pnl_row_data, pnl_id) => pnl_row_data,
+               (row, acc_orders, pnl_key) => row.with(working: WorkingOrderData.Create(acc_orders.table.state.Values.Select(t => t.order), row.qty_conversion)),
+               (row, pnl_id) => row,
                (acc_orders, pnl_id) => {
                   string account;
                   SecurityImmutable? security;
@@ -182,7 +200,9 @@ namespace mbts.spark {
                   return new PNLRowData(pnl_id,
                      security: security,
                      account_name: account,
-                     working: WorkingOrderData.Create(acc_orders.table.state.Values.Select(t => t.order)));
+                     working: WorkingOrderData.Create(
+                        acc_orders.table.state.Values.Select(t => t.order),
+                        new QuantityConversionData(security_auxiliary_model.get_display_quantity_divisor(security), QuantityConversionData.OpType.DivideActual)));
                },
                PNLRowData.key_fn)
                .Where(t => t.has_changes())
@@ -215,8 +235,11 @@ namespace mbts.spark {
             FillTuple.key_fn);
          on_fill_tuples_with_root = fill_order_tuples_with_root_join.Cache();
          // manual fills
-         on_manual_fills_securities = _position_service.subscribei_manual_fills()
-            .Naggle(interval, scheduler)
+         on_manual_fills_securities = admin_model
+            .permission_filter(
+               _position_service.subscribei_manual_fills()
+               .Naggle(interval, scheduler),
+               f => f.AccountId)
             .Filter(f => f.FillType == ManualFill.Types.FillType.Local)
             .join(sstore, mf => mf.SecurityKey)
             .Table().Cache();
@@ -279,7 +302,7 @@ namespace mbts.spark {
       public IObservable<TableUpdate<FillTuple, string>> on_fill_tuples { get; }
       public IObservable<TableUpdate<FillTuple, string>> on_fill_tuples_with_root { get; }
       public IObservable<IReadOnlyDictionary<uint, OrderSecurity>> working_orders { get; }
-      public IObservable<TableUpdate<(SecurityImmutable?, PNLUnitImmutable), int>> on_pnl { get; }
+      public IObservable<TableUpdate<(SecurityImmutable?, PNLUnitImmutable, QuantityConversionData), int>> on_pnl { get; }
       public IObservable<TableUpdate<PNLRowData, PNLKey>> security_account_pnl { get; }
       public IObservable<TableUpdate<(SecurityImmutable?, PositionUnitImmutable), int>> on_positions { get; }
       public IObservable<TableUpdate<(AlgoData algo, AlgoDefinitionMetadata? meta), AlgoKey>> studio_algos_with_meta { get; }

src/client/spark/Position/IPositionModel.cs

@@ -0,0 +1,44 @@
+using bts.spark;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel.Composition;
+using System.Linq;
+using System.Threading.Tasks;
+
+namespace bts.api.position {
+   interface IPositionModel {
+      Task<bool> override_cpp_async(IEnumerable<(uint security_key, double cpp)> cpp_overrides);
+   }
+
+   [Export(typeof(IPositionModel))]
+   class PositionModel : IPositionModel {
+      readonly PositionService _position_service;
+      readonly ErrorReporter _error_reporter;
+
+      [ImportingConstructor]
+      public PositionModel(PositionService position_service, ErrorReporter error_reporter) {
+         _position_service = position_service ?? throw new ArgumentNullException(nameof(position_service));
+         _error_reporter = error_reporter ?? throw new ArgumentNullException(nameof(error_reporter));
+      }
+
+      public Task<bool> override_cpp_async(IEnumerable<(uint security_key, double cpp)> cpp_overrides) {
+         var sec_params_batch_op = new SecurityParametersBatchOp();
+         sec_params_batch_op.OpParams.AddRange(cpp_overrides.Select(tup => new SecurityParameters {
+            SecurityKey = tup.security_key,
+            CppOverride = new CppOverride { Value = tup.cpp }
+         }));
+         return _error_reporter.safe_execute(
+            () => _position_service.update_security_parameters_async(sec_params_batch_op),
+            r => r.Ok,
+            r => r.Msg,
+            (v, success) => success,
+            "override cpp");
+      }
+   }
+
+   static class PositionModelExtensions {
+      public static Task<bool> override_cpp_async(this IPositionModel position_model, IEnumerable<uint> security_keys, double cpp) =>
+         (position_model ?? throw new ArgumentNullException(nameof(position_model)))
+         .override_cpp_async(security_keys.Select(k => (k, cpp)));
+   }
+}

src/client/spark/Security/ISecurityAuxiliaryDataModel.cs

@@ -0,0 +1,45 @@
+using bts.api;
+using bts.utils;
+using mbts.config;
+using System.Collections.Generic;
+using System.ComponentModel.Composition;
+
+namespace mbts.spark {
+   interface ISecurityAuxiliaryDataModel {
+      SecurityAuxiliaryData? get_auxiliary_data(SecurityImmutable security);
+   }
+
+   readonly struct SecurityAuxiliaryData {
+      public SecurityAuxiliaryData(uint quantity_divisor) =>
+         this.quantity_divisor = quantity_divisor;
+
+      public static SecurityAuxiliaryData Default => new SecurityAuxiliaryData(1);
+
+      public uint quantity_divisor { get; }
+   }
+
+   [Export(typeof(ISecurityAuxiliaryDataModel))]
+   class SecurityAuxiliaryDataModel : ISecurityAuxiliaryDataModel {
+      readonly Dictionary<string, SecurityAuxiliaryData> _auxiliary_data = new Dictionary<string, SecurityAuxiliaryData>();
+
+      public SecurityAuxiliaryDataModel() {
+         var sym_config = Configuration.get<bts.config.SymbolUIConfiguration>();
+         var sym_config_items = Configuration.get<bts.config.SymbolUIConfiguration>().items;
+         foreach (var item in sym_config_items)
+            _auxiliary_data[item.symbol] = new SecurityAuxiliaryData(item.display_quantity_divisor);
+      }
+
+      public SecurityAuxiliaryData? get_auxiliary_data(SecurityImmutable security) =>
+         security.ToString().SafeContains("ICE Lots") ?
+            new SecurityAuxiliaryData(1) :
+            _auxiliary_data.TryGetValue(security.Symbol, out var d) ? d : (SecurityAuxiliaryData?)null;
+   }
+
+   static class SecurityAuxiliaryDataModelExtensions {
+      public static uint get_display_quantity(this ISecurityAuxiliaryDataModel model, SecurityImmutable? security, uint actual_qty) =>
+         actual_qty.safe_divide(model.get_display_quantity_divisor(security));
+
+      public static uint get_display_quantity_divisor(this ISecurityAuxiliaryDataModel model, SecurityImmutable? security) =>
+         security.HasValue ? model.get_auxiliary_data(security.Value)?.quantity_divisor ?? 1 : 1;
+   }
+}

src/client/spark/Spark.csproj

@@ -12,6 +12,7 @@
     <RuntimeIdentifiers>win7-x64</RuntimeIdentifiers>
     <PlatformTarget>AnyCPU</PlatformTarget>
     <LanguageTargets>$(MSBuildExtensionsPath)\$(VisualStudioVersion)\Bin\Microsoft.CSharp.targets</LanguageTargets>
+    <LanguageTargets Condition="'$(VisualStudioVersion)'=='16.0'">$(MSBuildToolsPath)\Microsoft.CSharp.targets</LanguageTargets>
     <ApplicationIcon>logo.ico</ApplicationIcon>
     <OutputType>WinExe</OutputType>
     <StartupObject>mbts.ui.shell.App</StartupObject>

src/client/spark/core/Collections/KeyedItemSelector.cs

@@ -187,7 +187,7 @@ namespace mbts.collections {
       }
    }
 
-   class KeyedMultiSelector<T, TKey> : ViewModelBase where TKey : struct, IEquatable<TKey> {
+   class KeyedMultiSelector<T, TKey> : ViewModelBase where TKey : IEquatable<TKey> {
       readonly Func<T, TKey> _key_selector;
       HashSet<TKey> _desired_keys = new HashSet<TKey>();
 
@@ -204,7 +204,7 @@ namespace mbts.collections {
          try_select(key, true);
 
       public bool try_select(TKey key, bool reattempt_on_collection_change) {
-         if (items.TryGetFirst(i => _key_selector(i).Equals(key), out T result)) {
+         if (items.TryGetFirst(i => _key_selector(i).safe_equals(key), out T result)) {
             selected_items.Add(result);
             return true;
          } else if (reattempt_on_collection_change) {

src/client/spark/core/GlobalExtensions/DoubleHelper.cs

@@ -38,9 +38,6 @@ namespace mbts {
       public static bool IsNonZero(this double value) =>
          value != 0 && !double.IsNaN(value) && !double.IsInfinity(value);
 
-      public static bool IsRealNonZero(this double value) =>
-         value > 0 && value != double.PositiveInfinity;
-
       public static double CoerceNaN(double value) => CoerceNaN(value, 0.0);
       public static double CoerceNaN(double value, double if_nan) => double.IsNaN(value) ? if_nan : value;
       public static double CoerceNaNOrInfinity(double value) => CoerceNaNOrInfinity(value, 0.0);
@@ -63,5 +60,20 @@ namespace mbts {
 
       public static double? nan_nullable(double value) =>
          double.IsNaN(value) ? (double?)null : value;
+
+      public static int? to_optional_int32(double value) {
+         if (double.IsNaN(value) || double.IsInfinity(value))
+            return null;
+         if (value > 0) {
+            value = Math.Floor(value);
+            if (value <= int.MaxValue)
+               return (int)value;
+         } else if (value < 0) {
+            value = Math.Ceiling(value);
+            if (value >= int.MinValue)
+               return (int)value;
+         }
+         return null;
+      }
    }
 }

src/client/spark/core/data/Proto/ToggleInt32Proto.cs

@@ -0,0 +1,34 @@
+using ProtoBuf;
+using System;
+
+namespace bts.proto {
+   [ProtoContract]
+   readonly struct ToggleInt32Proto : IEquatable<ToggleInt32Proto> {
+      public ToggleInt32Proto(int value, bool is_enabled) {
+         this.value = value;
+         this.is_enabled = is_enabled;
+      }
+
+      [ProtoMember(1)]
+      public int value { get; }
+      [ProtoMember(2)]
+      public bool is_enabled { get; }
+
+      public bool Equals(ToggleInt32Proto other) =>
+         value == other.value && is_enabled == other.is_enabled;
+
+      public override bool Equals(object obj) =>
+         obj is ToggleInt32Proto other && Equals(other);
+
+      public override int GetHashCode() =>
+         (value % (1 << 31)) | (is_enabled ? 1 << 31 : 0);
+
+      public static bool operator ==(ToggleInt32Proto a, ToggleInt32Proto b) => a.Equals(b);
+      public static bool operator !=(ToggleInt32Proto a, ToggleInt32Proto b) => !a.Equals(b);
+   }
+
+   static class ToggleInt32ProtoExtensions {
+      public static int? as_nullable(this ToggleInt32Proto toggle) =>
+         toggle.is_enabled ? toggle.value : (int?)null;
+   }
+}

src/client/spark/view/Controls/DIYGrid/Columns/DIYGridColumn.cs

@@ -0,0 +1,9 @@
+namespace mbts.ui.controls {
+   class DIYGridColumn : DIYGrid.ColumnBase<string> {
+      public DIYGridColumn()
+         : base() {
+         is_visible = true;
+         Width = 60;
+      }
+   }
+}

src/client/spark/view/Controls/DIYGrid/Settings/Animation/SoundAnimationView.xaml.cs

@@ -38,11 +38,7 @@ namespace mbts.ui.controls {
       }
 
       public static ICommand PreviewSoundCommand =>
-         new DelegateCommand<SoundNotification.SystemSound>(s =>  {
-            try {
-               NAudioPlayer.create(s).play();
-            } catch (NAudio.MmException) { }
-         });
+         new DelegateCommand<SoundNotification.SystemSound>(NAudioPlayer.play);
 
       #region SoundTypes
       public static readonly DependencyProperty SoundTypesProperty =

src/client/spark/view/Controls/DataGridEx/Filters/DataGridFilterHelper.cs

@@ -59,6 +59,7 @@ namespace mbts.spark.filters {
          ULongMinMax = "ULongMinMaxTemplate",
          TimeFilter = "TimeFilterTemplate",
          DiscreteValues = "DiscreteValuesTemplate",
+         DiscreteValuesCollectionView = "DiscreteValuesCollectionViewTemplate",
          EnumValues = "EnumValuesTemplate",
          Regex = "RegexTemplate",
          YesNo = "YesNoTemplate";

src/client/spark/view/Controls/DataGridEx/Filters/VM/DiscreteValuesFilterVM.cs

@@ -70,7 +70,7 @@ namespace mbts.spark.filters {
          out IObserver<TableUpdate<TValue, TKey>> items_observer,
          out ListCollectionView<TValue> items_view,
          string prop_name = null)
-         where TKey : struct, IEquatable<TKey> =>
+         where TKey : IEquatable<TKey> =>
          //
          CreateTableUpdate(factory, key, keys => keys, keys => keys.ToArray(), out items_observer, out items_view, prop_name);
 
@@ -82,7 +82,7 @@ namespace mbts.spark.filters {
          out IObserver<TableUpdate<TValue, TKey>> items_observer,
          out ListCollectionView<TValue> items_view,
          string prop_name = null)
-         where TKey : struct, IEquatable<TKey> {
+         where TKey : IEquatable<TKey> {
          //
          var filter = new TableUpdateItemsFilter<TRow, TValue, TKey, TState>(factory, key, load_state, get_state, prop_name);
          items_observer = filter;
@@ -282,7 +282,7 @@ namespace mbts.spark.filters {
          }
       }
 
-      class TableUpdateItemsFilter<TRow, TValue, TKey, TState> : FilterVMBase<TRow, TValue, TState>, IObserver<TableUpdate<TValue, TKey>> where TKey : struct, IEquatable<TKey> {
+      class TableUpdateItemsFilter<TRow, TValue, TKey, TState> : FilterVMBase<TRow, TValue, TState>, IObserver<TableUpdate<TValue, TKey>> where TKey : IEquatable<TKey> {
          readonly ObservableKeyedCollection<TValue, TKey> _items;
          readonly KeyedMultiSelector<TValue, TKey> _selection_model;
          readonly Func<TValue, TKey> _key;

src/client/spark/view/Controls/DataGridEx/Filters/VM/RegexFilterVM.cs

@@ -1,39 +1,43 @@
-using System;
-using System.Text.RegularExpressions;
+using System;
+using System.Text.RegularExpressions;
+
+namespace mbts.spark.filters {
+   static class RegexFilterUtils {
+      public static Regex build_regex(string str) {
+         if (str == null)
+            return null;
+         str = str.Trim();
+         if (str == string.Empty)
+            return null;
+         return new Regex(str, RegexOptions.IgnoreCase | RegexOptions.IgnorePatternWhitespace);
+      }
+   }
+   class RegexFilterVM<TRow> : FilterVMBase<TRow, string, string> {
+      string _text = string.Empty;
+      Regex _regex;
+
+      public RegexFilterVM(Func<TRow, string> get_row_val, string prop_name = null) : base(get_row_val, prop_name) { }
+
+      public string text {
+         get => _text;
+         set => _regex = RegexFilterUtils.build_regex(_text = (value ?? string.Empty));
+      }
+
+      public override string get_state() => _text ?? string.Empty;
+
+      protected override bool _get_active() => _regex != null;
+      protected override bool _filter(string value) =>
+         _regex != null && (
+            _regex.IsMatch(value) ||
+            (!string.IsNullOrEmpty(value) && _regex.IsMatch(value.Replace(" ", ""))));
 
-namespace mbts.spark.filters {
-   static class RegexFilterUtils {
-      public static Regex build_regex(string str) {
-         if (str == null)
-            return null;
-         str = str.Trim();
-         if (str == string.Empty)
-            return null;
-         return new Regex(str, RegexOptions.IgnoreCase | RegexOptions.IgnorePatternWhitespace);
-      }
-   }
-   class RegexFilterVM<TRow> : FilterVMBase<TRow, string, string> {
-      string _text = string.Empty;
-      Regex _regex;
-
-      public RegexFilterVM(Func<TRow, string> get_row_val, string prop_name = null) : base(get_row_val, prop_name) { }
-
-      public string text {
-         get => _text;
-         set => _regex = RegexFilterUtils.build_regex(_text = (value ?? string.Empty));
-      }
-
-      public override string get_state() => _text ?? string.Empty;
-
-      protected override bool _get_active() => _regex != null;
-      protected override bool _filter(string value) => _regex != null && _regex.IsMatch(value);
-      protected override void _load_state_internal(string state) => text = state;
-      protected override void _clear() {
-         _close();
-         _text = string.Empty;
-         _regex = null;
-         RaisePropertyChanged(nameof(text));
-         _raise_filter_changed();
-      }
-   }
+      protected override void _load_state_internal(string state) => text = state;
+      protected override void _clear() {
+         _close();
+         _text = string.Empty;
+         _regex = null;
+         RaisePropertyChanged(nameof(text));
+         _raise_filter_changed();
+      }
+   }
 }

src/client/spark/view/Controls/DataGridEx/Filters/Views/FilterTemplates.xaml

@@ -1,10 +1,13 @@
-<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
-                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
-                    xmlns:u="clr-namespace:mbts.ui"
-                    xmlns:c="clr-namespace:mbts.ui.controls"
-                    xmlns:usp="clr-namespace:mbts.ui.spark"
-                    xmlns:msp="clr-namespace:mbts.spark"
-                    xmlns:sys="clr-namespace:System;assembly=mscorlib">
+<ResourceDictionary
+  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+  xmlns:filters="clr-namespace:mbts.spark.filters"
+  xmlns:u="clr-namespace:mbts.ui"
+  xmlns:c="clr-namespace:mbts.ui.controls"
+  xmlns:usp="clr-namespace:mbts.ui.spark"
+  xmlns:msp="clr-namespace:mbts.spark"
+  xmlns:sys="clr-namespace:System;assembly=mscorlib"
+>
   <ResourceDictionary.MergedDictionaries>
     <ResourceDictionary Source="/view/Resources/ComboBoxes.xaml"/>
     <ResourceDictionary Source="/view/Controls/DataGridEx/Filters/Views/DoubleMinMaxFilterControl.xaml"/>
@@ -147,6 +150,21 @@
       />
     </usp:FilterContentControl>
   </DataTemplate>
+  <DataTemplate x:Key="{x:Static filters:DataGridFilterKnownTemplates.DiscreteValuesCollectionView}">
+    <usp:FilterContentControl
+      ApplyCommandParameter="{Binding}"
+      ApplyCommand="{x:Static c:DataGridFilterProperties.CommitCommand}"
+      ClearCommandParameter="{Binding}"
+      ClearCommand="{x:Static c:DataGridFilterProperties.ClearCommand}"
+    >
+      <c:ListBoxEx
+        ItemsSource="{Binding items_view}"
+        Selection="{Binding selected_items}"
+        SelectionMode="Multiple"
+        ItemContainerStyle="{StaticResource ListBoxItemCheckBoxStyle}"
+      />
+    </usp:FilterContentControl>
+  </DataTemplate>
   <DataTemplate x:Key="AlgoTypeTemplate">
     <usp:FilterContentControl
       ApplyCommandParameter="{Binding}"

src/client/spark/view/Controls/Order/AlgoContentTemplateSelector.xaml

@@ -1005,6 +1005,8 @@
             ContractPickerModel="{Binding contract_picker_model}"
             HedgePricing="{Binding hedge_pricing}"
             HedgePricingItemsSource="{Binding hedge_pricing_options}"
+            UseFractionalTicks="{Binding use_fractional_ticks}"
+            IntegerTickSize="{Binding integer_tick_size}"
           />
           <c:DialogSkirt Grid.Row="1" Margin="-4" VerticalAlignment="Top" RightItems="{Binding skirt_items}"/>
         </Grid>

src/client/spark/view/Controls/PropertyEditor/PropertyEditor.xaml

@@ -0,0 +1,38 @@
+<ResourceDictionary 
+  x:Class="mbts.ui.controls.property_editor.PropertyEditorResources"
+  x:ClassModifier="internal"
+  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+  xmlns:c="clr-namespace:mbts.ui.controls"
+  xmlns:pe="clr-namespace:mbts.ui.controls.property_editor"
+>
+  <Thickness x:Key="PropertyLabelMargin" Left="0" Top="4" Right="4"/>
+  <Thickness x:Key="PropertyValueMargin" Top="4"/>
+  <DataTemplate DataType="{x:Static pe:PropertyEditorItemTypes.DoubleItem}">
+    <Grid>
+      <Grid.ColumnDefinitions>
+        <ColumnDefinition Width="Auto"/>
+        <ColumnDefinition Width="*"/>
+      </Grid.ColumnDefinitions>
+      <TextBlock VerticalAlignment="Center" Margin="{StaticResource PropertyLabelMargin}" Text="{Binding name}"/>
+      <c:TickUpDownDouble Grid.Column="1" VerticalAlignment="Center" Margin="{StaticResource PropertyValueMargin}" Value="{Binding value}"/>
+    </Grid>
+  </DataTemplate>
+  <DataTemplate DataType="{x:Type pe:PropertyEditorVM}">
+    <Grid>
+      <Grid.RowDefinitions>
+        <RowDefinition Height="*"/>
+        <RowDefinition Height="Auto"/>
+      </Grid.RowDefinitions>
+      <ItemsControl ItemsSource="{Binding properties}" Margin="8,4"/>
+      <c:DialogSkirt Grid.Row="1">
+        <c:DialogSkirt.RightItems>
+          <x:Array Type="{x:Type Button}">
+            <Button IsDefault="True" Command="{Binding commit_cmd}">OK</Button>
+            <Button IsCancel="True" Command="{Binding cancel_cmd}">Cancel</Button>
+          </x:Array>
+        </c:DialogSkirt.RightItems>
+      </c:DialogSkirt>
+    </Grid>
+  </DataTemplate>
+</ResourceDictionary>

src/client/spark/view/Controls/PropertyEditor/PropertyEditor.xaml.cs

@@ -0,0 +1,122 @@
+using mbts.spark;
+using mbts.ui.utilities;
+using mbts.ui.utility;
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+using System.Windows;
+using System.Windows.Controls;
+using System.Windows.Data;
+
+namespace mbts.ui.controls.property_editor {
+   partial class PropertyEditorResources : ResourceDictionary {
+      public PropertyEditorResources() {
+         InitializeComponent();
+      }
+   }
+
+   static class PropertyEditor {
+      static int _window_id;
+
+      public static Task<(double value, bool committed)> get_double_async(
+         string title,
+         string prompt,
+         CancellationToken cancellation_token,
+         double initial_value = 0,
+         Func<double, string> validate = null,
+         WindowStartupLocation startup_location = WindowStartupLocation.Manual,
+         int? offset_x = -72,
+         int? offset_y = -40) {
+         //
+         PropertyEditorItem<double> double_item = null;
+         return get_result_async(create_vm, _ => (double_item?.value ?? double.NaN, true), cancellation_token, init, tcs => tcs.TrySetResult((double.NaN, false)));
+         PropertyEditorVM create_vm() {
+            var vm = new PropertyEditorVM(title, prompt);
+            vm.properties.Add(double_item = new PropertyEditorItem<double>(prompt, validate) {
+               value = initial_value
+            });
+            return vm;
+         }
+         IDisposable init(PropertyEditorVM vm, Window dialog) {
+            _position_window(dialog, startup_location, offset_x, offset_y);
+            return null;
+         }
+      }
+
+      public static Task<TResult> get_result_async<TResult>(
+         Func<PropertyEditorVM> create_vm,
+         Func<PropertyEditorVM, TResult> get_result,
+         CancellationToken cancellation_token,
+         Func<PropertyEditorVM, Window, IDisposable> init = null,
+         Action<TaskCompletionSource<TResult>> premature_close_callback = null) {
+         //
+         var tcs = new TaskCompletionSource<TResult>();
+         var window_name = $"{nameof(PropertyEditor)} - {Interlocked.Increment(ref _window_id)}";
+         var launcher = new ThreadedWindowLauncher(window_name, 1);
+         launcher.show(create_win_impl);
+         return tcs.Task;
+         Window create_win_impl() {
+            var vm = create_vm();
+            var win = new Window {
+               DataContext = vm,
+               Resources = new PropertyEditorResources(),
+               SizeToContent = SizeToContent.WidthAndHeight
+            };
+            win.SetResourceReference(FrameworkElement.StyleProperty, "BTSDialog");
+            win.SetBinding(ContentControl.ContentProperty, new Binding());
+            win.SetBinding(Window.TitleProperty, nameof(PropertyEditorVM.title));
+            var dispose = init?.Invoke(vm, win);
+            IDisposable check_canceled_loop = null;
+            vm.RequestCommit += on_request_commit;
+            vm.RequestClose += on_request_close;
+            win.Closed += on_premature_closed;
+            check_canceled_loop = WorkLoop.Start($"{window_name} cancellation loop", () => {
+               if (cancellation_token.IsCancellationRequested && win != null) {
+                  Disposable.dispose(ref check_canceled_loop);
+                  WindowUtilities.force_close(win);
+               }
+            });
+            return win;
+            void on_request_commit(object sender, EventArgs e) {
+               detach_and_dispose();
+               WindowUtilities.force_close(win);
+               win = null;
+               end_task()?.TrySetResult(get_result(vm));
+            }
+            void on_request_close(object sender, EventArgs e) {
+               detach_and_dispose();
+               WindowUtilities.force_close(win);
+               win = null;
+               premature_close_callback?.Invoke(end_task());
+            }
+            void on_premature_closed(object sender, EventArgs e) {
+               detach_and_dispose();
+               win = null;
+               premature_close_callback?.Invoke(end_task());
+            }
+            void detach_and_dispose() {
+               Disposable.dispose(ref check_canceled_loop);
+               Disposable.dispose(ref dispose);
+               win.Closed -= on_premature_closed;
+               vm.RequestCommit -= on_request_commit;
+               vm.RequestClose -= on_request_close;
+            }
+            TaskCompletionSource<TResult> end_task() {
+               var temp_tcs = tcs;
+               tcs = null;
+               return temp_tcs;
+            }
+         }
+      }
+
+      static void _position_window(Window window, WindowStartupLocation startup_location, int? offset_x = null, int? offset_y = null) {
+         window.WindowStartupLocation = startup_location;
+         if (startup_location == WindowStartupLocation.Manual && (offset_x.HasValue || offset_y.HasValue))
+            window.move_to_mouse(offset_x ?? 0, offset_y ?? 0);
+      }
+   }
+
+   static class PropertyEditorItemTypes {
+      public static Type DoubleItem => typeof(PropertyEditorItem<double>);
+   }
+}

src/client/spark/view/Controls/PropertyEditor/PropertyEditorVM.cs

@@ -0,0 +1,62 @@
+using mbts.ui.shell;
+using System;
+using System.Collections.ObjectModel;
+using System.ComponentModel;
+using System.Windows.Input;
+
+namespace mbts.ui.controls.property_editor {
+   interface IPropertyEditorItem : INotifyPropertyChanged {
+      string name { get; }
+      object value { get; set; }
+   }
+
+   interface IPropertyEditorItem<T> : IPropertyEditorItem {
+      new T value { get; set; }
+   }
+
+   class PropertyEditorItem<T> : ViewModelBaseWithValidation, IPropertyEditorItem<T> {
+      readonly Func<T, string> _validate;
+      T _value;
+
+      public PropertyEditorItem(string name, Func<T, string> validate) {
+         this.name = name ?? throw new ArgumentNullException(nameof(name));
+         _validate = validate;
+      }
+
+      public string name { get; }
+
+      public T value {
+         get => _value;
+         set {
+            if (_validate == null) {
+               Set(ref _value, value);
+            } else {
+               using (validation(nameof(value))) {
+                  Set(ref _value, value);
+                  string error = _validate(value);
+                  validation_assert(error != null, error, nameof(value));
+               }
+            }
+         }
+      }
+
+      object IPropertyEditorItem.value { get => value; set => value = (T)value; }
+   }
+
+   class PropertyEditorVM : ViewModelBase, IRequestViewClose {
+      public PropertyEditorVM(string title, string prompt) {
+         this.title = title ?? throw new ArgumentNullException(nameof(title));
+         this.prompt = prompt ?? throw new ArgumentNullException(nameof(prompt));
+         commit_cmd = new DelegateCommand(() => RequestCommit?.Invoke(this, EventArgs.Empty));
+         cancel_cmd = new DelegateCommand(() => RequestClose?.Invoke(this, EventArgs.Empty));
+      }
+
+      public event EventHandler RequestCommit, RequestClose;
+
+      public string title { get; }
+      public string prompt { get; }
+      public ObservableCollection<object> properties { get; } = new ObservableCollection<object>();
+      public ICommand commit_cmd { get; }
+      public ICommand cancel_cmd { get; }
+   }
+}

src/client/spark/view/Converters/BooleanToVisibilityConverter.cs

@@ -12,6 +12,9 @@ namespace mbts.ui.converters
       public Visibility VisibilityForFalse { get { return _visfalse; } set { _visfalse = value; } }
 
       public static BooleanToVisibilityConverter Instance => new BooleanToVisibilityConverter();
+      public static BooleanToVisibilityConverter HiddenInstance => new BooleanToVisibilityConverter {
+         VisibilityForFalse = Visibility.Hidden
+      };
 
       public object Convert(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture) {
          bool flag = false;

src/client/spark/view/Converters/Numeric/DoubleDivisorConverter.cs

@@ -0,0 +1,38 @@
+using bts.utils;
+using System;
+using System.Globalization;
+using System.Windows.Controls;
+using System.Windows.Data;
+
+namespace mbts.ui.converters {
+   [ValueConversion(typeof(double), typeof(string))]
+   class DoubleDivisorConverter : IValueConverter {
+      public double Divisor { get; set; }
+
+      public object Convert(object value, Type targetType, object parameter, CultureInfo culture) =>
+         value is double d ? d.safe_divide(Divisor) :
+         value is int i ? i.safe_divide(Divisor) :
+         value is uint u ? u.safe_divide(Divisor) :
+         double.NaN;
+
+      public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture) =>
+         value is double d ? d * Divisor :
+         value is int i ? (double)i * Divisor :
+         value is uint u ? (double)u * Divisor :
+         double.NaN;
+   }
+
+   class DynamicDoubleDivisorConverter : IMultiValueConverter {
+      public static DynamicDoubleDivisorConverter Instance { get; } = new DynamicDoubleDivisorConverter();
+
+      public object Convert(object[] values, Type targetType, object parameter, CultureInfo culture) {
+         if (ConvertUtils.try_convert_args(values, out double value, out double div)) {
+            return value.safe_divide(div);
+         }
+         return new ValidationResult(false, "unable to convert values to doubles.");
+      }
+
+      public object[] ConvertBack(object value, Type[] targetTypes, object parameter, CultureInfo culture) =>
+         throw new NotSupportedException();
+   }
+}

src/client/spark/view/Converters/Numeric/DoubleMultiplierConverter.cs

@@ -1,5 +1,6 @@
 using System;
 using System.Globalization;
+using System.Windows.Controls;
 using System.Windows.Data;
 
 namespace mbts.ui.converters {
@@ -19,4 +20,18 @@ namespace mbts.ui.converters {
          value is uint u ? (double)u / Multiplier :
          double.NaN;
    }
-}
+
+   class DynamicDoubleMultiplierConverter : IMultiValueConverter {
+      public static DynamicDoubleMultiplierConverter Instance { get; } = new DynamicDoubleMultiplierConverter();
+
+      public object Convert(object[] values, Type targetType, object parameter, CultureInfo culture) {
+         if (ConvertUtils.try_convert_args(values, out double value, out double mult)) {
+            return value * mult;
+         }
+         return new ValidationResult(false, "unable to convert values to doubles.");
+      }
+
+      public object[] ConvertBack(object value, Type[] targetTypes, object parameter, CultureInfo culture) =>
+         throw new NotSupportedException();
+   }
+}