Portable TIMi Installation v0.3
===============================

1. Extract the zip file "TIMiPortable_x64.zip" (for a 64-bit installation)

2. Run the executable "<root_of_install_dir>\Add_TIMi_ShortCut_On_Your_Desktop.exe".
   This will create 2 shortcuts (one shortcut to run TIMi and one shortcuts to run 
   Anatella) on your desktop.

3. If you are experiencing any difficulties, please run with ADMINISTRATOR PRIVILEGES:
   "<root_of_install_dir>\bin\TIMiFileAssociation.exe" and re-try.

Notes about the content of each directory
=========================================

* "AnatellaDemo": contains some demonstration Anatella-transformation-graphs.
* "bin": The heart of the TIMi suite. This directory contains:
   # The 3 main tools inside the TIMi Suite: Modeler, Anatella and Stardust:
       To run TIMi:     run the executable "<root_of_install_dir>\bin\TIMiMainMenu.exe"
       To run Anatella: run the executable "<root_of_install_dir>\bin\Anatella.exe"
       To run Stardust: run the executable "<root_of_install_dir>\bin\Stardust.exe"
     It's a good idea to add to you desktop or start menu some links (or shortcuts)
     to the above 3 executables.
   # The documentation for Anatella, Modeler & Stardust as 3 PDF files:
     TIMiQuickGuide.pdf, AnatellaQuickGuide.pdf, StarDustQuickGuide.pdf.
   # "foxe.exe": A small xml-file editor.
   # "zip.exe": the famous archiving/compressor software available as a command-line tool.
   # "ShpView.exe": A small tool to view shape files.
* "curl/curl.exe": A command-line tool to download/upload nearly any file from/to anywhere. 
  This is very handy to download large files from a FTP/HTTP sites. CURL is also used 
  internally by TIMi to access the TIMi credential server (when using "network licences").
* "EditPadLite7/EditPadLite7.exe": A text-file editor that is able to open large unicode text files.
  You can use this text-file editor to edit all XML configuration files of the TIMi Suite (this
  includes, for example: .DsourceXML, .TypeXML, .CfgXML, .Anatella files). This text-file editor 
  is also very handy to open the large text file reports produced by TIMi Modeler (i.e. the Audit 
  reports or the Analyst reports).
* "gnuplot/wgnuplot.exe": A command-line tool that generates the TIMi Modeler PNG-charts (it's used 
  internally by TIMi Modeler).
* "IrfanView/i_view32.exe": A fast image file viewer. You can use this image viewer to quickly
  view all the charts (mainly: the "Lift" charts) generated by TIMi.
* "mosquitto": a MQTT Broker: useful to process IoT messages with Anatella.
* "oracle": The OCI drivers to connect natively to Oracle.
* "putty/TIMi_PSCP.exe": A command-line tool to download/upload from/to SSH-secured sites.
* "python": an (Anaconda) Python engine: required to execute Python Actions inside Anatella.
            You can safely delete this directory and replace it with any (Anaconda) Python 
            engine of your choice.
* "R": a R engine: required to execute R Actions inside Anatella.
       In addition to the R engine, this directory also contains pre-installed 
       non-standard R librairies. If you delete this directory to replace it with another 
       R engine of your choice, you'll need to re-download & re-install some R libraries.
* "StarDustVR": the VR engine included inside Stardust 
* "Spatialite_doc": the documentation about the GIS extentions for Anatella.
* "tableau": the engine to create the old .tde files for Tableau
* "tableau2": the engine to create .hyper files for Tableau
* "textures": the textures used inside Stardust. Feel free to change them as needed.


File Associations
-----------------

These file Associations used by the "TIMi Suite":
1. Used by Anatella:
   .anatella    : open these files with "<root_of_install_dir>\bin\AnatellaServer.exe"
2. Used by Modeler:
   .DSourceXML  : open these files with "<root_of_install_dir>\bin\TIMiServer.exe"
   .TypeXML     : open these files with "<root_of_install_dir>\bin\TIMiServer.exe"
   .CfgXML	: open these files with "<root_of_install_dir>\bin\TIMiServer.exe"
   .ModelXML    : open these files with "<root_of_install_dir>\bin\TIMiServer.exe"
3. Used by Modeler&Stardust:
   .DescXML     : open these files with "<root_of_install_dir>\bin\TIMiServer.exe"
4. Used by Stardust:
   .SegXML      : open these files with "<root_of_install_dir>\bin\StarDust.exe"

The "bin\TIMiFileAssociation.exe" application resets the MSWindows file 
associations just as described here above.
To know more about file-associations:
    http://en.wikipedia.org/wiki/File_association
    https://docs.microsoft.com/en-us/windows/desktop/shell/fa-intro

Here is a brief description of the purpose of each file type:
1. Modeler files
   .CfgXML	: contains all the meta-parameters related to the creation of one predictive model
   .TypeXML     : contains all the types (Value,Modal,Binary) of all the columns of the dataset
   .DSourceXML  : contains all the system-parameters required to access the dataset
   .ModelXML    : represents one predictive model (binary or continuous).
2. Modeler&Stardust files:
   .DescXML     : Open this file to start a new segmentation analysis with Stardust
3. Stardust files:
   .SegXML      : contains a snapshot-in-time of the global state of Stardust when performing 
                  a segmentation Analysis.
   .SModelXML   : represents one segmentation model (PCA + k-means + ward)
4. Anatella files:
   .anatella    : represents one anatella data-transformation-graph.
   .gel_anatella: This file format is used by Anatella to internally store the different working, 
                  temporary datasets during run-time.
   .cgel_anatella: This file format is used by Anatella to store large datasets.
   .rModel      : a predictive model created with Anatella (using internally the R engine to score
                  new datasets).
