Browse code

update RD

Simone authored on 27/03/2021 15:11:43
Showing 4 changed files

... ...
@@ -1,5 +1,5 @@
1 1
 % Generated by roxygen2: do not edit by hand
2
-% Please edit documentation in R/S3Cover-Param.R
2
+% Please edit documentation in R/S3filter_extract_param.R
3 3
 \name{filter-extract}
4 4
 \alias{filter-extract}
5 5
 \alias{FULL}
... ...
@@ -19,7 +19,7 @@ to be used in filter and extract function.
19 19
 }
20 20
 \details{
21 21
 It is used to encompasses all the region parameters already present 
22
-into the dataset or GrangesList
22
+into the dataset or GRangesList
23 23
 
24 24
 \itemize{
25 25
 \item{FULL: It consider all the region paramter}
... ...
@@ -71,8 +71,28 @@ filter_and_extract(test_path, region_attributes = c("pvalue", "peak"))
71 71
 ## function makes sure that the region coordinates (chr, ranges, strand)
72 72
 ## of all samples are ordered correctly
73 73
 
74
-
75 74
 grl <- import_gmql(test_path, TRUE)
76 75
 sorted_grl <- sort(grl)
77 76
 filter_and_extract(sorted_grl, region_attributes = c("pvalue", "peak"))
77
+
78
+## It is also possible to define the region attributes, using the FULL() 
79
+## function parameter, in order to includes every region 
80
+## attributes present into the schema file
81
+
82
+sorted_grl_full <- sort(grl)
83
+filter_and_extract(sorted_grl, region_attributes = FULL())
84
+
85
+grl <- import_gmql(test_path, TRUE)
86
+sorted_grl <- sort(grl)
87
+filter_and_extract(sorted_grl, region_attributes = FULL())
88
+
89
+## Also, we can inlcude a list of region attribute inside the FULL() 
90
+## function to exlucde that regions
91
+
92
+sorted_grl_full_except <- sort(grl)
93
+filter_and_extract(
94
+ sorted_grl_full_except, 
95
+ region_attributes = FULL("jaccard", "score")
96
+)
97
+
78 98
 }
... ...
@@ -49,6 +49,21 @@ generated:
49 49
 \item{"provider" = "PoliMi"}
50 50
 \item{"application" = "RGMQL"}
51 51
 }
52
+
53
+NOTE: 
54
+The folder layout must obey the following rules and adopt 
55
+the following layout:
56
+The dataset folder can have any name, but must contains the 
57
+sub-folders named: "files".
58
+The sub-folder "files" contains the dataset files and 
59
+the schema xml file.
60
+The schema files adopt the following the naming conventions:
61
+
62
+- "schema.xml"
63
+- "test.schema"
64
+
65
+The names must be in LOWERCASE. Any other schema file 
66
+will not be conisdered, if both are present, "test.schema" will be used.
52 67
 }
53 68
 \examples{
54 69
 
... ...
@@ -74,4 +89,5 @@ remote_url = "http://www.gmql.eu/gmql-rest/"
74 89
 login_gmql(remote_url)
75 90
 data1 = read_gmql("public.Example_Dataset_1", is_local = FALSE)
76 91
 
92
+
77 93
 }
... ...
@@ -41,6 +41,21 @@ a new dataset is created on remote repository
41 41
 \details{
42 42
 If no error occurs, it prints "Upload Complete", otherwise a specific error 
43 43
 is printed
44
+
45
+NOTE: 
46
+The folder layout must obey the following rules and adopt 
47
+the following layout:
48
+The dataset folder can have any name, but must contains the 
49
+sub-folders named: "files".
50
+The sub-folder "files" contains the dataset files and 
51
+the schema xml file.
52
+The schema files adopt the following the naming conventions:
53
+
54
+- "schema.xml"
55
+- "test.schema"
56
+
57
+The names must be in LOWERCASE. Any other schema file 
58
+will not be conisdered, if both are present, "test.schema" will be used.
44 59
 }
45 60
 \examples{
46 61