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{
}}