// Modify this file to provide a description of your toolbox.
// This file is used by Atoms GUI in scilab, to show information about the toolbox.
//
// Note that it will NOT be used when publishing your toolbox on http://atoms.scilab.org;
// the present file is only used if you distribute your toolbox yourself.
// On the http://atoms.scilab.org site, only the information you provide there is used.
//
//
// Lines starting with // are comments
// (you can remove all the comments designed to help you)
// Lines starting with a space are continuation of the previous field.
// Empty lines separate fields.

// Unique identifier for this toolbox.
// It must be alphanumeric, start with a letter and contain neither space
// nor special characters other than underscore or dash.
Toolbox: dataint

// Human-friendly name for your toolbox
Title: dataINT

// One-line description for your toolbox
Summary: dataINT provides GUI-supported INTERACTIVE reading & writing of text (csv, dat) & Excel data files (xls, xlsx)

// Version number, in format 'major.minor.patch', or
// 'major.minor.patch', where all fields are numbers.
// If you are just starting your toolbox, you should use '0.1' or '0.1.0'.
// Use '1.0' or '1.0.0' for a tested, good quality first version.
Version: 2.0.0

// Name(s) of the author(s) of this toolbox.
// They are usually the original copyright holders
// (persons or entities)
Author: Hani A. Ibrahim

// Name(s) and email address(es) of the person(s) maintaining this toolbox
Maintainer: Hani A. Ibrahim (hani.ibrahim@gmx.de)
 
// Categories that this toolbox belongs to.
// The toolbox will appear in the Scilab Atoms GUI
// under the categories that you select here.
Category: Data Handling

// Name of the institution (company, university, lab...) who has developed the toolbox.
// If you developed the toolbox as an individual, then just enter "private individual"
Entity: private individual

// Optional website that has more information about this toolbox
WebSite: https://github.com/haniibrahim/scilab-dataint

// License under which the toolbox will be published
License: GPL 3.0

// Version of Scilab supported by this toolbox,
// prefixed by =, >= ...
ScilabVersion: >= 2024.0

// Other toolbox(es) that must be installed in order
// this toolboxes to work. Atoms will automatically ensure that
// the dependent toolboxes listed here are installed on the user's
// Scilab installation.
// Each toolbox dependency must be in format:
//    <operator> <toolbox name> <toolbox version|any>
// where operator can be: ~, >, <, >=, <=
// If multiple dependencies, put one per line (starting each line with a space) e.g. >= apifun 0.4.0
Depends: ~ apifun any
 ~ xlreadwrite any
 ~ helptbx any

// Creation date, e.g.  2019-05-05
Date: 2022-05-09

Description: Toolbox for easy and interactive reading and writing of text/Excel numerical data files

 dataINT offers functions for convenient, interactive im-/export of test-based 
 data (*.csv, *.dat, *.txt) or Excel files (*.xls, *.xlsx) to or from a Scilab double 
 matrix, respectively.
 
 dataINT handles:
 - comma separated text data files
 - semicolon separated text data files
 - space separated text data files
 - tabulator separated text data files
 - BIFF Excel 95-2003 files (*.xls)
 - XML Excel 2010-365 files (*.xlsx)
 
 Parameters, to specify the im-/export, can conveniently entered in a 
 graphical dialog box and the file selection is done by the platform-specific 
 file selection dialog.
 
 You can specify the following im-/export parameters for text data files:
 - Field separator (comma, semicolon, tab, space)
 - Decimal separator (comma, point)
 - Rows and columns you want to import 
 - Number of lines to skip, e.g. header line/s (reading only)
 - Comment header line to describe your data  (writing only)
 
 and for Excel files:
 - Specifying worksheet number or worksheet name
 - Reading just a cell range or whole worksheet
 - Writing data from a specified start cell on
 
 NEW: dataINT 2.0.0 does handle data from XML-based Excel files (.xlsx), now!
 
 NOTE: dataINT cannot work with Excel's binary *.xlsb files!
 NOTE: dataINT handles doubles only. Non-real-numerical data is imported as NaN.
 
 The functions can easily integrated in your own scripts to make use of 
 dataINT's interactive functionality or to simplify your data import in 
 Scilab's console.
 
 FUNCTIONS:
 
 * DI_read
   Read text numerical data (*.csv, *.dat, *.txt) and Excel (*.xls, *.xlsx) files 
   in a Scilab matrix variable.
 * DI_show
   Read the first 25 or an arbitrary number of lines of a text data file,    
   displays them in the console and invoke the reading procedure after, if
   desired.
 * DI_writedat
   Write comma-separated value (*.csv, *.dat, *.txt) or Excel (*.xls, *.xlsx) 
   files interactively. File extension determines the output format.
 
 dataINT versions are available for Scilab 5.5.x, 6.x & 2023, 2024, 2025, 2026.
 dataINT 2.0.0 works from Scilab 2024.0 on. Testet on 2024.1.0, 2025.1.0, 2026.1.0.
 Furthermore dataINT is cross-platform.
 
 IMPORTANT: IF YOU HAVE INSTALLED  dataINT 1.2.2-rev UNINSTALL IT USING
 ========== atomsRemove('dataint')
            RESTART SCILAB BEFORE INSTALLING VERSION 2.0.0!
 
 ---------------------------------------------------------------------
  
 CHANGELOG:
 2.0.0
 - Write BIFF Excel 95-2003 files (*.xls)
 - Read and write XML Excel 2010-365 files (*.xlsx)
 - Deprecation message displayed for DI_readcsv and DI_readxls. 
   Successor of both is still DI_read with the same API.
 
 1.2.0
 - DI_show function added
 - DI_writedat replaces DI_writecsv
 - Deprecation of DI_readcsv and DI_readxls. Successor of both is DI_read
 
 1.1.1
 - Fix decimal-comma-bug when reading/parsing space separated text files 
   with decimal commas
 
 1.1.0 
 - DI_read function introduced
 - Better input parameter checking
 - Easier input of data ranges for import
 
 1.0.1 Bug fixes: 
 - "test" print in DI_readcsv())
 - Syntax/Calling Sequence missing bug in help-files
 - some minor improvements 
