<commit_before>Installation
============

.. note::
    The easiest way to try out TileDB is to use a pre-built Docker image::

        docker pull tiledb/tiledb
        docker run -it tiledb/tiledb
    
    which uses the latest TileDB version, or:: 

        docker pull tiledb/tiledb:<version>
        docker run -it tiledb/tiledb:<version>

    which uses a specific TileDB version (ex. ``<version>`` could be ``1.2.0``). 

    More info at `TileDB Docker Hub repo <https://hub.docker.com/r/tiledb/tiledb/>`_ and the `TileDB-Docker repo <https://github.com/TileDB-Inc/TileDB-Docker>`_.

Pre-built Packages
------------------

Homebrew
~~~~~~~~

TileDB can be installed easily using the Homebrew package manager for macOS. Install instructions for Homebrew are provided on the `package manager's website <https://brew.sh/>`_.

To install the latest stable version of TileDB::

    brew update
    brew install tiledb-inc/stable/tiledb

To upgrade to the latest stable version of TileDB::

    brew upgrade tiledb-inc/stable/tiledb

To uninstall TileDB::

    brew uninstall tiledb-inc/stable/tiledb

Homebrew Tap is located at https://github.com/TileDB-Inc/homebrew.

Conda
~~~~~

A package for TileDB is available for the `Conda package manager <https://conda.io/docs/>`_. Conda makes it easy to install software into separate distinct environments on Windows, Linux, and macOS.

::

    conda install -c conda-forge tiledb

**Note**: Conda packages are not currently built with the HDFS and S3 storage backends enabled.

Windows Binaries
~~~~~~~~~~~~~~~~

The easiest way to install TileDB on Windows is to download the .zip file containing pre-built Windows binaries from the `latest TileDB release <https://github.com/TileDB-Inc/TileDB/releases>`_. You can then simply configure your project (if using Visual Studio) according to the :ref:`Windows usage <windows-usage>` instructions.

Requirements
------------

Operating Systems
~~~~~~~~~~~~~~~~~

TileDB has been tested on **Ubuntu Linux** (v.14.04+), **CentOS Linux** (v.7+), **macOS Sierra** (v.10.12) and **Windows** (7+), but TileDB should work with any reasonably recent version of Ubuntu, CentOS, macOS or Windows with an installed compiler supporting C++11.

Required Dependencies
~~~~~~~~~~~~~~~~~~~~~

TileDB requires a recent version of the `CMake <https://cmake.org/>`_ build system.

TileDB has minimal required dependencies and currently relies on the following libraries for compression:

* `zlib <https://zlib.net/>`_
* `LZ4 <http://lz4.github.io/lz4/>`_
* `bzip2 <http://www.bzip.org/>`_
* `Zstandard <http://facebook.github.io/zstd/>`_
* `Blosc <http://blosc.org/pages/blosc-in-depth/>`_<commit_msg>add docs on installing / building with conda-prefix<commit_after>Installation
============

.. note::
    The easiest way to try out TileDB is to use a pre-built Docker image::

        docker pull tiledb/tiledb
        docker run -it tiledb/tiledb
    
    which uses the latest TileDB version, or:: 

        docker pull tiledb/tiledb:<version>
        docker run -it tiledb/tiledb:<version>

    which uses a specific TileDB version (ex. ``<version>`` could be ``1.2.0``). 

    More info at `TileDB Docker Hub repo <https://hub.docker.com/r/tiledb/tiledb/>`_ and the `TileDB-Docker repo <https://github.com/TileDB-Inc/TileDB-Docker>`_.

Pre-built Packages
------------------

Homebrew
~~~~~~~~

TileDB can be installed easily using the Homebrew package manager for macOS. Install instructions for Homebrew are provided on the `package manager's website <https://brew.sh/>`_.

To install the latest stable version of TileDB::

    brew update
    brew install tiledb-inc/stable/tiledb

To upgrade to the latest stable version of TileDB::

    brew upgrade tiledb-inc/stable/tiledb

To uninstall TileDB::

    brew uninstall tiledb-inc/stable/tiledb

Homebrew Tap is located at https://github.com/TileDB-Inc/homebrew.

Conda
~~~~~

A package for TileDB is available for the `Conda package manager <https://conda.io/docs/>`_. Conda makes it easy to install software into separate distinct environments on Windows, Linux, and macOS.

::

    conda install -c conda-forge tiledb

**Note**: Conda packages are not currently built with the HDFS and S3 storage backends enabled.

If you are compiling / linking against the TileDB conda package,
you need to explicity add the conda env path after activation:

::

    export CPATH=$CONDA_PREFIX/include
    export LIBRARY_PATH=$CONDA_PREFIX/lib
    export LD_LIBRARY_PATH=$CONDA_PREFIX/lib

Or as command line flags during compilation:

::

    gcc -I$CONDA_PREFIX/include -L$CONDA_PREFIX/lib -ltiledb tiledb_example.cc -o tiledb_example

Windows Binaries
~~~~~~~~~~~~~~~~

The easiest way to install TileDB on Windows is to download the .zip file containing pre-built Windows binaries from the `latest TileDB release <https://github.com/TileDB-Inc/TileDB/releases>`_. You can then simply configure your project (if using Visual Studio) according to the :ref:`Windows usage <windows-usage>` instructions.

Requirements
------------

Operating Systems
~~~~~~~~~~~~~~~~~

TileDB has been tested on **Ubuntu Linux** (v.14.04+), **CentOS Linux** (v.7+), **macOS Sierra** (v.10.12) and **Windows** (7+), but TileDB should work with any reasonably recent version of Ubuntu, CentOS, macOS or Windows with an installed compiler supporting C++11.

Required Dependencies
~~~~~~~~~~~~~~~~~~~~~

TileDB requires a recent version of the `CMake <https://cmake.org/>`_ build system.

TileDB has minimal required dependencies and currently relies on the following libraries for compression:

* `zlib <https://zlib.net/>`_
* `LZ4 <http://lz4.github.io/lz4/>`_
* `bzip2 <http://www.bzip.org/>`_
* `Zstandard <http://facebook.github.io/zstd/>`_
* `Blosc <http://blosc.org/pages/blosc-in-depth/>`_
{'fraction_non_alphanumeric': 0.1331493618489134, 'fraction_numerical': 0.006898930665746809, 'mean_word_length': 3.8124481327800828, 'pattern_counts': {'":': 0, '<': 33, '<?xml version=': 0, '>': 33, 'https://': 16, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5187490', 'n_tokens_mistral': 1830, 'n_tokens_neox': 1731, 'n_words': 638}