% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/interval_format_conversions.R
\name{to_all_interval_formats}
\alias{to_all_interval_formats}
\title{Convert Interval Data to All Supported Formats}
\usage{
to_all_interval_formats(x, ...)
}
\arguments{
\item{x}{Interval data in one of the supported formats:
\code{"RSDA"}, \code{"MM"}, \code{"iGAP"}, \code{"ARRAY"},
\code{"SODAS"}, or \code{"SDS"}.}

\item{...}{Additional arguments passed to conversion functions (e.g.,
\code{location} for iGAP input).}
}
\value{
A named list with six slots:
\describe{
  \item{\code{RSDA}}{A \code{symbolic_tbl} with complex-encoded
    \code{symbolic_interval} columns.}
  \item{\code{MM}}{A \code{data.frame} with paired \code{_min}/\code{_max}
    columns.}
  \item{\code{iGAP}}{A \code{data.frame} with comma-separated
    \code{"min,max"} character values.}
  \item{\code{ARRAY}}{A three-dimensional numeric \code{array} of dimension
    \code{[n, p, 2]} where \code{[,,1]} stores minima and \code{[,,2]}
    stores maxima.}
  \item{\code{SODAS}}{\code{NULL} unless the input is a SODAS XML file path,
    in which case it stores the original path.}
  \item{\code{SDS}}{\code{NULL} unless the input is a SODAS/SDS XML file path
    (alias for SODAS).}
}
}
\description{
Convert interval data from any recognized format to all six
supported interval data formats and return the results as a named list.
This is useful for inspecting and comparing how the same interval data is
represented across different formats.
}
\details{
Six interval data formats are supported in this package.  Each format
stores the same information -- lower and upper bounds for every variable of
every observation -- but differs in its structure and origin:

\describe{
  \item{\strong{RSDA}}{
    A \code{symbolic_tbl} object (class
    \code{c("symbolic_tbl", "tbl_df", "tbl", "data.frame")}) where each
    interval variable is a complex column (\code{symbolic_interval}):
    \code{Re()} gives the minimum and \code{Im()} gives the maximum.
    This is the native format of the \pkg{RSDA} package
    (Billard & Diday, 2006; Rodriguez, 2024).
  }
  \item{\strong{MM (Min-Max)}}{
    A plain \code{data.frame} where each interval variable is represented by
    two numeric columns named \code{<var>_min} and \code{<var>_max}.
    This is a widely used general-purpose representation.
  }
  \item{\strong{iGAP}}{
    A \code{data.frame} where each interval variable is stored as a character
    column with comma-separated values \code{"min,max"}.
    This is the format used by the \pkg{iGAP} software (Correia, 2009).
  }
  \item{\strong{ARRAY}}{
    A three-dimensional numeric \code{array} of size \code{[n, p, 2]}.
    The first slice \code{[,,1]} contains all minima and the second slice
    \code{[,,2]} contains all maxima.  Dimnames encode observation labels,
    variable names, and \code{c("min", "max")}.  This format is convenient
    for matrix-based computations.
  }
  \item{\strong{SODAS}}{
    An XML file on disk produced by the SODAS software (Diday & Noirhomme,
    2008).  In R, SODAS data is referenced by its file path and read via
    \code{RSDA::SODAS.to.RSDA()}.  Since SODAS is a file-based format, it
    cannot be generated from in-memory data.
  }
  \item{\strong{SDS}}{
    An alias for SODAS.  Both refer to the same XML-based format.
  }
}
}
\examples{
data(car.int)
result <- to_all_interval_formats(car.int)
names(result)

# RSDA format (symbolic_tbl)
result$RSDA

# MM format (data.frame with _min/_max columns)
head(result$MM)

# iGAP format (data.frame with comma-separated values)
head(result$iGAP)

# ARRAY format (3D array)
dim(result$ARRAY)
result$ARRAY[1:3, , 1]  # minima
result$ARRAY[1:3, , 2]  # maxima

# SODAS/SDS slots are NULL (file-based format)
result$SODAS
result$SDS
}
\references{
Billard, L. and Diday, E. (2006).
\emph{Symbolic Data Analysis: Conceptual Statistics and Data Mining}.
Wiley.

Rodriguez, O. (2024).
\emph{RSDA: R to Symbolic Data Analysis}.
R package, \url{https://CRAN.R-project.org/package=RSDA}.

Correia, M. (2009).
\emph{Interval GARCH and Aggregation of Predictions}.

Diday, E. and Noirhomme-Fraiture, M. (2008).
\emph{Symbolic Data Analysis and the SODAS Software}.
Wiley.
}
\seealso{
\code{\link{int_detect_format}}, \code{\link{int_convert_format}},
  \code{\link{int_list_conversions}}
}
\author{
Han-Ming Wu
}
