This is an old revision of the document!
TOOL was originally built when memory was scarce and processors were slow. Each tool was optimized for performance in that world, which meant fixed positions for dimensions. Usually the key dimension a single input tool operated on would have to be on the far right and for binary tools (operating on 2 inputs) would require matching dimensions in specific locations. Reorders were scattered through out the code to accommodate these requirements.
Over the years processors and memory improved and the more commonly used tools which operate on one key dimension have been improved to take advantage of the better machines by allowing the key dimension to be anywhere. This reduces the need for reorders and makes the tool code much easier to read and to write.
Recently the “binary” type tools which operate with 2 inputs that interact with each other have been improved too so the order of dimensions does not have to be matching in any way. This has really improved code readability but at a cost of memory.
Today TOOL code is much easier to read and write which is ideal and as long as your objects have a “reasonable” number of elements (say 100M or less) you don't need to think about TOOL memory efficiency. If you have more elements or you are running with a memory strapped machine you do have to concern yourself with efficiency, read on.
Facts for a 32bit machine:
These are the limitations we have until we move to 64bit machines and optimize the TOOL language to use it.
Any tool will need memory for all it's inputs AND outputs but not always enough for the full objects to be in memory. How much of the objects are pulled into memory depends on how the objects are ordered. Read on!
These tools can have the “key” dimension usually specified with dim= anywhere in the object but the further to the right it is the less of the input objects will have to be in memory at a time.
For example: if you have an object A[a,b,c,d]
If key dimension is d the tool will bring in y elements of the object into memory at a time where y = extent(d). It will then process that section and then move on to the next section also size extent(d). This will be repeated x times where x = extent(a) * extent(b) * extent©.
If key dimension is b the tool will bring in y elements of the object into memory at a time where y = extent(b) * extent© * extent(d). It will then process that section and then move on to the next section. This will be repeated x times where x = extent(a)
These tools q