// 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 userfriendly INTERACTIVE reading and writing of csv- and xls-datafiles

// 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: 1.2.2

// 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 developped the toolbox.
// If you developped 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.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

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

Description: Toolbox for easy and interactive reading and writing of data files

 dataINT offers functions for convenient, interactive im-/export of test-based 
 data files (*.csv, *.dat, *.txt) to or from a Scilab matrix or from a binary 
 Excel files (*.xls), respectively. 
 
 Parameters, to specify the im-/export, can conveniently entered in a dialog  
 box and the file selection is done by the platform-specific 
 file selection dialog.
 
 You can specify the following im-/export parameters:
 - Field separator (comma, semicolon, tab, space)
 - Decimal separator (comma, point)
 - Rows and columns you want to import
 - Sheet you want to import 
 - Number of lines to skip, e.g. header line(s)
 - Comment header line to describe your data 
 
 IMPORTANT: dataINT does not handle data from XML-based Excel files (.xlsx)!
 NOTE: dataINT handles doubles only.
 
 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
   Combines functionality of DI_readcsv and DI_readxls in one function
 * 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 files (*.csv, *.dat, *.txt) interactively.
 
 dataINT is available for Scilab 5.5.x, 6.x, 6.1.x. & 2023, 2024, 2025, 2026 
 Furthermore dataINT is cross-platform.
 
  ---------------------------------------------------------------------
   
 CHANGELOG:
 1.2.1/1.2.2
 - Fixed start problems with 2025.0.0 on Linux and macOS. Works also with 2026.1.0.
 
 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 
