X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/db166b9539a0f18621e2c980137d082357b1a680..c68e4ba51336a871dff26ae9f8dc7eb7e316083d:/sdk/R/man/Collection.Rd
diff --git a/sdk/R/man/Collection.Rd b/sdk/R/man/Collection.Rd
index 5fbf1c1a11..0de9a842e6 100644
--- a/sdk/R/man/Collection.Rd
+++ b/sdk/R/man/Collection.Rd
@@ -13,76 +13,97 @@ for exaplme actions like creating, updating, moving or removing are possible.
## Method `Collection$new`
## ------------------------------------------------
+\dontrun{
collection <- Collection$new(arv, CollectionUUID)
+}
## ------------------------------------------------
## Method `Collection$readArvFile`
## ------------------------------------------------
+\dontrun{
collection <- Collection$new(arv, collectionUUID)
readFile <- collection$readArvFile(arvadosFile, istable = 'yes') # table
readFile <- collection$readArvFile(arvadosFile, istable = 'no') # text
readFile <- collection$readArvFile(arvadosFile) # xlsx, csv, tsv, rds, rdata
-readFile <- collection$readArvFile(arvadosFile, fileclass = 'lala') # fasta
+readFile <- collection$readArvFile(arvadosFile, fileclass = 'fasta') # fasta
readFile <- collection$readArvFile(arvadosFile, Ncol= 4, Nrow = 32) # binary, only numbers
readFile <- collection$readArvFile(arvadosFile, Ncol = 5, Nrow = 150, istable = "factor") # binary with factor or text
+}
## ------------------------------------------------
## Method `Collection$writeFile`
## ------------------------------------------------
+\dontrun{
collection <- Collection$new(arv, collectionUUID)
-writeFile <- collection$writeFile("myoutput.csv", file, istable = NULL) # csv
-writeFile <- collection$writeFile("myoutput.fasta", file, istable = NULL) # fasta
-writeFile <- collection$writeFile("myoutputtable.txt", file, istable = "yes") # txt table
-writeFile <- collection$writeFile("myoutputtext.txt", file, istable = "no") # txt text
-writeFile <- collection$writeFile("myoutputbinary.dat", file) # binary
-writeFile <- collection$writeFile("myoutputxlsx.xlsx", file) # xlsx
+writeFile <- collection$writeFile(name = "myoutput.csv", file = file, fileFormat = "csv", istable = NULL, collectionUUID = collectionUUID) # csv
+writeFile <- collection$writeFile(name = "myoutput.tsv", file = file, fileFormat = "tsv", istable = NULL, collectionUUID = collectionUUID) # tsv
+writeFile <- collection$writeFile(name = "myoutput.fasta", file = file, fileFormat = "fasta", istable = NULL, collectionUUID = collectionUUID) # fasta
+writeFile <- collection$writeFile(name = "myoutputtable.txt", file = file, fileFormat = "txt", istable = "yes", collectionUUID = collectionUUID) # txt table
+writeFile <- collection$writeFile(name = "myoutputtext.txt", file = file, fileFormat = "txt", istable = "no", collectionUUID = collectionUUID) # txt text
+writeFile <- collection$writeFile(name = "myoutputbinary.dat", file = file, fileFormat = "dat", collectionUUID = collectionUUID) # binary
+writeFile <- collection$writeFile(name = "myoutputxlsx.xlsx", file = file, fileFormat = "xlsx", collectionUUID = collectionUUID) # xlsx
+}
## ------------------------------------------------
## Method `Collection$create`
## ------------------------------------------------
+\dontrun{
collection <- arv$collections_create(name = collectionTitle, description = collectionDescription, owner_uuid = collectionOwner, properties = list("ROX37196928443768648" = "ROX37742976443830153"))
+}
## ------------------------------------------------
## Method `Collection$remove`
## ------------------------------------------------
+\dontrun{
collection$remove(fileName.format)
+}
## ------------------------------------------------
## Method `Collection$move`
## ------------------------------------------------
+\dontrun{
collection$move("fileName.format", path)
+}
## ------------------------------------------------
## Method `Collection$copy`
## ------------------------------------------------
+\dontrun{
copied <- collection$copy("oldName.format", "newName.format")
+}
## ------------------------------------------------
## Method `Collection$refresh`
## ------------------------------------------------
+\dontrun{
collection$refresh()
+}
## ------------------------------------------------
## Method `Collection$getFileListing`
## ------------------------------------------------
+\dontrun{
list <- collection$getFileListing()
+}
## ------------------------------------------------
## Method `Collection$get`
## ------------------------------------------------
+\dontrun{
arvadosFile <- collection$get(fileName)
}
+}
\seealso{
-\code{\link{https://github.com/arvados/arvados/tree/main/sdk/R}}
+https://git.arvados.org/arvados.git/tree/HEAD:/sdk/R
}
\section{Public fields}{
\if{html}{\out{
}}
@@ -94,24 +115,24 @@ arvadosFile <- collection$get(fileName)
\section{Methods}{
\subsection{Public methods}{
\itemize{
-\item \href{#method-new}{\code{Collection$new()}}
-\item \href{#method-add}{\code{Collection$add()}}
-\item \href{#method-readArvFile}{\code{Collection$readArvFile()}}
-\item \href{#method-writeFile}{\code{Collection$writeFile()}}
-\item \href{#method-create}{\code{Collection$create()}}
-\item \href{#method-remove}{\code{Collection$remove()}}
-\item \href{#method-move}{\code{Collection$move()}}
-\item \href{#method-copy}{\code{Collection$copy()}}
-\item \href{#method-refresh}{\code{Collection$refresh()}}
-\item \href{#method-getFileListing}{\code{Collection$getFileListing()}}
-\item \href{#method-get}{\code{Collection$get()}}
-\item \href{#method-getRESTService}{\code{Collection$getRESTService()}}
-\item \href{#method-setRESTService}{\code{Collection$setRESTService()}}
+\item \href{#method-Collection-new}{\code{Collection$new()}}
+\item \href{#method-Collection-add}{\code{Collection$add()}}
+\item \href{#method-Collection-readArvFile}{\code{Collection$readArvFile()}}
+\item \href{#method-Collection-writeFile}{\code{Collection$writeFile()}}
+\item \href{#method-Collection-create}{\code{Collection$create()}}
+\item \href{#method-Collection-remove}{\code{Collection$remove()}}
+\item \href{#method-Collection-move}{\code{Collection$move()}}
+\item \href{#method-Collection-copy}{\code{Collection$copy()}}
+\item \href{#method-Collection-refresh}{\code{Collection$refresh()}}
+\item \href{#method-Collection-getFileListing}{\code{Collection$getFileListing()}}
+\item \href{#method-Collection-get}{\code{Collection$get()}}
+\item \href{#method-Collection-getRESTService}{\code{Collection$getRESTService()}}
+\item \href{#method-Collection-setRESTService}{\code{Collection$setRESTService()}}
}
}
\if{html}{\out{
}}
-\if{html}{\out{
}}
-\if{latex}{\out{\hypertarget{method-new}{}}}
+\if{html}{\out{
}}
+\if{latex}{\out{\hypertarget{method-Collection-new}{}}}
\subsection{Method \code{new()}}{
Initialize new enviroment.
\subsection{Usage}{
@@ -132,7 +153,9 @@ A new `Collection` object.
}
\subsection{Examples}{
\if{html}{\out{
}}
-\preformatted{collection <- Collection$new(arv, CollectionUUID)
+\preformatted{\dontrun{
+collection <- Collection$new(arv, CollectionUUID)
+}
}
\if{html}{\out{
}}
@@ -140,8 +163,8 @@ A new `Collection` object.
}
\if{html}{\out{
}}
-\if{html}{\out{
}}
-\if{latex}{\out{\hypertarget{method-add}{}}}
+\if{html}{\out{
}}
+\if{latex}{\out{\hypertarget{method-Collection-add}{}}}
\subsection{Method \code{add()}}{
Adds ArvadosFile or Subcollection specified by content to the collection. Used only with ArvadosFile or Subcollection.
\subsection{Usage}{
@@ -159,8 +182,8 @@ Adds ArvadosFile or Subcollection specified by content to the collection. Used o
}
}
\if{html}{\out{
}}
-\if{html}{\out{
}}
-\if{latex}{\out{\hypertarget{method-readArvFile}{}}}
+\if{html}{\out{
}}
+\if{latex}{\out{\hypertarget{method-Collection-readArvFile}{}}}
\subsection{Method \code{readArvFile()}}{
Read file content.
\subsection{Usage}{
@@ -197,26 +220,35 @@ Read file content.
}
\subsection{Examples}{
\if{html}{\out{
}}
-\preformatted{collection <- Collection$new(arv, collectionUUID)
+\preformatted{\dontrun{
+collection <- Collection$new(arv, collectionUUID)
readFile <- collection$readArvFile(arvadosFile, istable = 'yes') # table
readFile <- collection$readArvFile(arvadosFile, istable = 'no') # text
readFile <- collection$readArvFile(arvadosFile) # xlsx, csv, tsv, rds, rdata
-readFile <- collection$readArvFile(arvadosFile, fileclass = 'lala') # fasta
+readFile <- collection$readArvFile(arvadosFile, fileclass = 'fasta') # fasta
readFile <- collection$readArvFile(arvadosFile, Ncol= 4, Nrow = 32) # binary, only numbers
readFile <- collection$readArvFile(arvadosFile, Ncol = 5, Nrow = 150, istable = "factor") # binary with factor or text
}
+}
\if{html}{\out{
}}
}
}
\if{html}{\out{
}}
-\if{html}{\out{
}}
-\if{latex}{\out{\hypertarget{method-writeFile}{}}}
+\if{html}{\out{
}}
+\if{latex}{\out{\hypertarget{method-Collection-writeFile}{}}}
\subsection{Method \code{writeFile()}}{
Write file content
\subsection{Usage}{
-\if{html}{\out{
}}\preformatted{Collection$writeFile(name, file, istable = NULL, seqName = NULL)}\if{html}{\out{
}}
+\if{html}{\out{
}}\preformatted{Collection$writeFile(
+ name,
+ file,
+ collectionUUID,
+ fileFormat,
+ istable = NULL,
+ seqName = NULL
+)}\if{html}{\out{
}}
}
\subsection{Arguments}{
@@ -232,13 +264,16 @@ Write file content
}
\subsection{Examples}{
\if{html}{\out{
}}
-\preformatted{collection <- Collection$new(arv, collectionUUID)
-writeFile <- collection$writeFile("myoutput.csv", file, istable = NULL) # csv
-writeFile <- collection$writeFile("myoutput.fasta", file, istable = NULL) # fasta
-writeFile <- collection$writeFile("myoutputtable.txt", file, istable = "yes") # txt table
-writeFile <- collection$writeFile("myoutputtext.txt", file, istable = "no") # txt text
-writeFile <- collection$writeFile("myoutputbinary.dat", file) # binary
-writeFile <- collection$writeFile("myoutputxlsx.xlsx", file) # xlsx
+\preformatted{\dontrun{
+collection <- Collection$new(arv, collectionUUID)
+writeFile <- collection$writeFile(name = "myoutput.csv", file = file, fileFormat = "csv", istable = NULL, collectionUUID = collectionUUID) # csv
+writeFile <- collection$writeFile(name = "myoutput.tsv", file = file, fileFormat = "tsv", istable = NULL, collectionUUID = collectionUUID) # tsv
+writeFile <- collection$writeFile(name = "myoutput.fasta", file = file, fileFormat = "fasta", istable = NULL, collectionUUID = collectionUUID) # fasta
+writeFile <- collection$writeFile(name = "myoutputtable.txt", file = file, fileFormat = "txt", istable = "yes", collectionUUID = collectionUUID) # txt table
+writeFile <- collection$writeFile(name = "myoutputtext.txt", file = file, fileFormat = "txt", istable = "no", collectionUUID = collectionUUID) # txt text
+writeFile <- collection$writeFile(name = "myoutputbinary.dat", file = file, fileFormat = "dat", collectionUUID = collectionUUID) # binary
+writeFile <- collection$writeFile(name = "myoutputxlsx.xlsx", file = file, fileFormat = "xlsx", collectionUUID = collectionUUID) # xlsx
+}
}
\if{html}{\out{
}}
@@ -246,8 +281,8 @@ writeFile <- collection$writeFile("myoutputxlsx.xlsx", file)
}
\if{html}{\out{
}}
-\if{html}{\out{
}}
-\if{latex}{\out{\hypertarget{method-create}{}}}
+\if{html}{\out{
}}
+\if{latex}{\out{\hypertarget{method-Collection-create}{}}}
\subsection{Method \code{create()}}{
Creates one or more ArvadosFiles and adds them to the collection at specified path.
\subsection{Usage}{
@@ -263,7 +298,9 @@ Creates one or more ArvadosFiles and adds them to the collection at specified pa
}
\subsection{Examples}{
\if{html}{\out{
}}
-\preformatted{collection <- arv$collections_create(name = collectionTitle, description = collectionDescription, owner_uuid = collectionOwner, properties = list("ROX37196928443768648" = "ROX37742976443830153"))
+\preformatted{\dontrun{
+collection <- arv$collections_create(name = collectionTitle, description = collectionDescription, owner_uuid = collectionOwner, properties = list("ROX37196928443768648" = "ROX37742976443830153"))
+}
}
\if{html}{\out{
}}
@@ -271,8 +308,8 @@ Creates one or more ArvadosFiles and adds them to the collection at specified pa
}
\if{html}{\out{
}}
-\if{html}{\out{
}}
-\if{latex}{\out{\hypertarget{method-remove}{}}}
+\if{html}{\out{
}}
+\if{latex}{\out{\hypertarget{method-Collection-remove}{}}}
\subsection{Method \code{remove()}}{
Remove one or more files from the collection.
\subsection{Usage}{
@@ -288,7 +325,9 @@ Remove one or more files from the collection.
}
\subsection{Examples}{
\if{html}{\out{
}}
-\preformatted{collection$remove(fileName.format)
+\preformatted{\dontrun{
+collection$remove(fileName.format)
+}
}
\if{html}{\out{
}}
@@ -296,8 +335,8 @@ Remove one or more files from the collection.
}
\if{html}{\out{
}}
-\if{html}{\out{
}}
-\if{latex}{\out{\hypertarget{method-move}{}}}
+\if{html}{\out{
}}
+\if{latex}{\out{\hypertarget{method-Collection-move}{}}}
\subsection{Method \code{move()}}{
Moves ArvadosFile or Subcollection to another location in the collection.
\subsection{Usage}{
@@ -315,7 +354,9 @@ Moves ArvadosFile or Subcollection to another location in the collection.
}
\subsection{Examples}{
\if{html}{\out{
}}
-\preformatted{collection$move("fileName.format", path)
+\preformatted{\dontrun{
+collection$move("fileName.format", path)
+}
}
\if{html}{\out{
}}
@@ -323,8 +364,8 @@ Moves ArvadosFile or Subcollection to another location in the collection.
}
\if{html}{\out{
}}
-\if{html}{\out{
}}
-\if{latex}{\out{\hypertarget{method-copy}{}}}
+\if{html}{\out{
}}
+\if{latex}{\out{\hypertarget{method-Collection-copy}{}}}
\subsection{Method \code{copy()}}{
Copies ArvadosFile or Subcollection to another location in the collection.
\subsection{Usage}{
@@ -342,7 +383,9 @@ Copies ArvadosFile or Subcollection to another location in the collection.
}
\subsection{Examples}{
\if{html}{\out{
}}
-\preformatted{copied <- collection$copy("oldName.format", "newName.format")
+\preformatted{\dontrun{
+copied <- collection$copy("oldName.format", "newName.format")
+}
}
\if{html}{\out{
}}
@@ -350,8 +393,8 @@ Copies ArvadosFile or Subcollection to another location in the collection.
}
\if{html}{\out{
}}
-\if{html}{\out{
}}
-\if{latex}{\out{\hypertarget{method-refresh}{}}}
+\if{html}{\out{
}}
+\if{latex}{\out{\hypertarget{method-Collection-refresh}{}}}
\subsection{Method \code{refresh()}}{
Refreshes the environment.
\subsection{Usage}{
@@ -360,7 +403,9 @@ Refreshes the environment.
\subsection{Examples}{
\if{html}{\out{
}}
-\preformatted{collection$refresh()
+\preformatted{\dontrun{
+collection$refresh()
+}
}
\if{html}{\out{
}}
@@ -368,8 +413,8 @@ Refreshes the environment.
}
\if{html}{\out{
}}
-\if{html}{\out{
}}
-\if{latex}{\out{\hypertarget{method-getFileListing}{}}}
+\if{html}{\out{
}}
+\if{latex}{\out{\hypertarget{method-Collection-getFileListing}{}}}
\subsection{Method \code{getFileListing()}}{
Returns collections file content as character vector.
\subsection{Usage}{
@@ -378,7 +423,9 @@ Returns collections file content as character vector.
\subsection{Examples}{
\if{html}{\out{
}}
-\preformatted{list <- collection$getFileListing()
+\preformatted{\dontrun{
+list <- collection$getFileListing()
+}
}
\if{html}{\out{
}}
@@ -386,8 +433,8 @@ Returns collections file content as character vector.
}
\if{html}{\out{
}}
-\if{html}{\out{
}}
-\if{latex}{\out{\hypertarget{method-get}{}}}
+\if{html}{\out{
}}
+\if{latex}{\out{\hypertarget{method-Collection-get}{}}}
\subsection{Method \code{get()}}{
If relativePath is valid, returns ArvadosFile or Subcollection specified by relativePath, else returns NULL.
\subsection{Usage}{
@@ -403,7 +450,9 @@ If relativePath is valid, returns ArvadosFile or Subcollection specified by rela
}
\subsection{Examples}{
\if{html}{\out{
}}
-\preformatted{arvadosFile <- collection$get(fileName)
+\preformatted{\dontrun{
+arvadosFile <- collection$get(fileName)
+}
}
\if{html}{\out{
}}
@@ -411,8 +460,8 @@ If relativePath is valid, returns ArvadosFile or Subcollection specified by rela
}
\if{html}{\out{
}}
-\if{html}{\out{
}}
-\if{latex}{\out{\hypertarget{method-getRESTService}{}}}
+\if{html}{\out{
}}
+\if{latex}{\out{\hypertarget{method-Collection-getRESTService}{}}}
\subsection{Method \code{getRESTService()}}{
\subsection{Usage}{
\if{html}{\out{
}}\preformatted{Collection$getRESTService()}\if{html}{\out{
}}
@@ -420,8 +469,8 @@ If relativePath is valid, returns ArvadosFile or Subcollection specified by rela
}
\if{html}{\out{
}}
-\if{html}{\out{
}}
-\if{latex}{\out{\hypertarget{method-setRESTService}{}}}
+\if{html}{\out{
}}
+\if{latex}{\out{\hypertarget{method-Collection-setRESTService}{}}}
\subsection{Method \code{setRESTService()}}{
\subsection{Usage}{
\if{html}{\out{
}}\preformatted{Collection$setRESTService(newRESTService)}\if{html}{\out{
}}