=============================================
Load, Save, Import and Export data in Gitools
=============================================


Gitools' file formats
---------------------
When saving a heatmap or an analysis, the format in which the heatmap/analysis is saved will be a native Gitools format.
Thus, these file types can be opened with Gitools only. Also note that Gitools can directly open and save in
\*.zip format, so there is no need to extract the archive.

Read about the native :doc:`UserGuide_GitoolsHeatmapsFormat` which you can **load** and **save** from within Gitools.
Loading and Saving are actions which need no input from the user at all. Gitools can store and load heatmaps
and all the visual attributes in ``.heatmap`` and ``.heatmap.zip`` which therefore are great formats to pass on a data
set with a certain formatting to your collaborators and colleagues.

If you have preformed an analysis, the result can be saved as :file:`name-of-analysis.analysis-type.zip`.


Here is a list of the native Gitools formats:

==========================  =======================================
Gitools data type           File extension
==========================  =======================================
Heatmap                     ``.heatmaps, .heatmaps.zip``
Enrichment Analysis         ``.enrichment, .enrichment.zip``
Overlap Analyis             ``.overlapping, .overlapping.zip``
Group Comparison Analysis   ``.comparison, .comparison.zip``
Correlation Analysis        ``.correlations, .correlations.zip``
Combination Analysis        ``.combinations, .combinations.zip``
==========================  =======================================

Import & Export
---------------

When **Importing**, Gitools will ask for user input in order to know how to represent the data. **Exporting** refers to
a data form which can either not be loaded again in Gitools (such as a figure/image) or to a rudimentary data form which
needs to be imported again, such as flat text files.

Import my own data into Gitools
...............................

Read about :doc:`UserGuide_ImportingData` if you have **your own data** in a text file or Excel table and want to load it
in Gitools.

There you can find :ref:`importformats`  and how you can load them as different :ref:`datatypes`, such as
matrix, annotation and modules.

Export data from Gitools
........................

Find a list of possible ways to :doc:`UserGuide_Export`




