qsar-report 1.0.0 → 1.0.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/README.md +10 -5
- data/VERSION +1 -1
- data/example/example.rb +38 -32
- metadata +2 -3
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
|
-
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
2
|
+
SHA256:
|
3
|
+
metadata.gz: 104056a6f62296b06a038eb182a983b5ec6629c66a0f76cebffcabefc49a6f2c
|
4
|
+
data.tar.gz: d8afaccbf23bbf7691503111046201bffcf9bbe54170c04d52bcd1cc8eb6b864
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 8ef3702db13efd99e8202f00d2c52bd65c2acefe7249e69024de76e638c1acad600a4c81eb2c655e583e90e894ceb170ccd27c54cc437c6bc5a48cbc73a0edeb
|
7
|
+
data.tar.gz: af46a3d5eb0ca5657fc045bba62dd1eead937f8a0d3495217fd813c13913ffd8e41059bd74f460a31556d9691e91a6d5b1afc29bdd336697e8ca739a70dc9ea6
|
data/README.md
CHANGED
@@ -1,14 +1,19 @@
|
|
1
1
|
# QSAR-Report
|
2
|
-
QMRF and QPRF reporting extension to OpenTox ruby modules and lazar.
|
2
|
+
QMRF and QPRF reporting extension to OpenTox ruby modules and lazar.
|
3
|
+
The QSAR-report gem was developed to extend the lazar and nano-lazar toxicity prediction application with QMRF and QPRF reporting features.
|
4
|
+
The library gem is independent from lazar or nano-lazar and can also be used in any other ruby code.
|
5
|
+
|
3
6
|
## About
|
4
|
-
|
5
|
-
|
7
|
+
Classes for QMRF and QPRF reporting.
|
8
|
+
|
9
|
+
* **OpenTox::QMRFReport**:
|
6
10
|
Provides a ruby OpenTox class to prepare an initial version of a QMRF report.
|
7
11
|
The XML output is in QMRF version 1.3 and can be finalized with the QMRF editor 2.0 (https://sourceforge.net/projects/qmrf/)
|
8
|
-
*
|
12
|
+
* **OpenTox::QPRFReport**:
|
9
13
|
Provides a ruby OpenTox class to prepare an initial version of a QPRF (version 1.1) report in JSON or HTML.
|
10
14
|
|
11
15
|
## Usage
|
16
|
+
|
12
17
|
### QMRF
|
13
18
|
create a new QMRF report, add some content and show output:
|
14
19
|
```ruby
|
@@ -66,7 +71,7 @@ puts report.pretty_json
|
|
66
71
|
Installation
|
67
72
|
------------
|
68
73
|
|
69
|
-
|
74
|
+
gem install qsar-report
|
70
75
|
|
71
76
|
Documentation
|
72
77
|
-------------
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.0.
|
1
|
+
1.0.1
|
data/example/example.rb
CHANGED
@@ -10,7 +10,7 @@ prediction_model = Model::Prediction.find_by :model_id => params[:id]
|
|
10
10
|
validation_template = File.join(File.dirname(__FILE__),"../views/model_details.haml") #detailed validation results from lazar-rest
|
11
11
|
|
12
12
|
|
13
|
-
# Start filling the QMRF report
|
13
|
+
# Start filling the QMRF report
|
14
14
|
|
15
15
|
# QSAR identifier (title) 1.1
|
16
16
|
report.value "QSAR_title", "Model for #{prediction_model.species} #{prediction_model.endpoint}"
|
@@ -22,10 +22,16 @@ report.ref_catalog :QSAR_software, :software_catalog, :firstsoftware
|
|
22
22
|
# Date of QMRF 2.1
|
23
23
|
report.value "qmrf_date", "#{Time.now.strftime('%d %B %Y')}"
|
24
24
|
|
25
|
-
# QMRF author(s) and contact details 2.
|
25
|
+
# QMRF author(s) and contact details 2.2
|
26
26
|
report.change_catalog :authors_catalog, :firstauthor, {:name => "Christoph Helma", :affiliation => "in silico toxicology gmbh", :contact => "Contact Address", :email => "Contact Email", :number => "1", :url => "Web Page"}
|
27
27
|
report.ref_catalog :qmrf_authors, :authors_catalog, :firstauthor
|
28
28
|
|
29
|
+
# Date of QMRF update(s) 2.3
|
30
|
+
report.value "qmrf_date_revision", ""
|
31
|
+
|
32
|
+
# QMRF update(s) 2.4
|
33
|
+
report.value "qmrf_revision", ""
|
34
|
+
|
29
35
|
# Model developer(s) and contact details 2.5
|
30
36
|
report.change_catalog :authors_catalog, :modelauthor, {:name => "Christoph Helma", :affiliation => "in silico toxicology gmbh", :contact => "Contact Address", :email => "Contact Email", :number => "1", :url => "Web Page"}
|
31
37
|
report.ref_catalog :model_authors, :authors_catalog, :modelauthor
|
@@ -42,9 +48,9 @@ report.change_catalog :publications_catalog, :publications_catalog_2, {:title =>
|
|
42
48
|
report.ref_catalog :references, :publications_catalog, :publications_catalog_2
|
43
49
|
|
44
50
|
# Species 3.1
|
45
|
-
report.value "model_species", prediction_model.species
|
51
|
+
report.value "model_species", prediction_model.species
|
46
52
|
|
47
|
-
# Endpoint 3.2
|
53
|
+
# Endpoint 3.2
|
48
54
|
report.change_catalog :endpoints_catalog, :endpoints_catalog_1, {:name => prediction_model.endpoint, :group => ""}
|
49
55
|
report.ref_catalog :model_endpoint, :endpoints_catalog, :endpoints_catalog_1
|
50
56
|
|
@@ -75,23 +81,23 @@ report.ref_catalog :descriptors_generation_software, :software_catalog, :softwar
|
|
75
81
|
# Chemicals/Descriptors ratio 4.7
|
76
82
|
report.value "descriptors_chemicals_ratio", "not applicable (classification based on activities of neighbors, descriptors are used for similarity calculation)"
|
77
83
|
|
78
|
-
# Some QMRF fields (tag contents) can have formatted HTML contents.
|
79
|
-
# These contents have to have a complete HTML document structure with basic surrounding tags like <html><body>.
|
80
|
-
# see Example below
|
84
|
+
# Some QMRF fields (tag contents) can have formatted HTML contents.
|
85
|
+
# These contents have to have a complete HTML document structure with basic surrounding tags like <html><body>.
|
86
|
+
# see Example below
|
81
87
|
|
82
88
|
# Description of the applicability domain of the model 5.1
|
83
89
|
report.value "app_domain_description", "<html><head></head><body>
|
84
90
|
<p>
|
85
|
-
The applicability domain (AD) of the training set is characterized by
|
86
|
-
the confidence index of a prediction (high confidence index: close to
|
87
|
-
the applicability domain of the training set/reliable prediction, low
|
88
|
-
confidence: far from the applicability domain of the
|
89
|
-
trainingset/unreliable prediction). The confidence index considers (i)
|
90
|
-
the similarity and number of neighbors and (ii) contradictory examples
|
91
|
+
The applicability domain (AD) of the training set is characterized by
|
92
|
+
the confidence index of a prediction (high confidence index: close to
|
93
|
+
the applicability domain of the training set/reliable prediction, low
|
94
|
+
confidence: far from the applicability domain of the
|
95
|
+
trainingset/unreliable prediction). The confidence index considers (i)
|
96
|
+
the similarity and number of neighbors and (ii) contradictory examples
|
91
97
|
within the neighbors. A formal definition can be found in Helma 2006.
|
92
98
|
</p>
|
93
99
|
<p>
|
94
|
-
The reliability of predictions decreases gradually with increasing
|
100
|
+
The reliability of predictions decreases gradually with increasing
|
95
101
|
distance from the applicability domain (i.e. decreasing confidence index)
|
96
102
|
</p>
|
97
103
|
</body>
|
@@ -100,7 +106,7 @@ report.value "app_domain_description", "<html><head></head><body>
|
|
100
106
|
# Method used to assess the applicability domain 5.2
|
101
107
|
report.value "app_domain_method", "see Helma 2006 and Maunz 2008"
|
102
108
|
|
103
|
-
# Software name and version for applicability domain assessment 5.3
|
109
|
+
# Software name and version for applicability domain assessment 5.3
|
104
110
|
report.change_catalog :software_catalog, :software_catalog_3, {:name => "lazar, submitted version: #{lazar_commit}", :description => "integrated into main lazar algorithm", :number => "3", :url => "https://lazar.in-silico.ch", :contact => "Contact Email"}
|
105
111
|
report.ref_catalog :app_domain_software, :software_catalog, :software_catalog_3
|
106
112
|
|
@@ -135,10 +141,10 @@ end
|
|
135
141
|
# Mechanistic basis of the model 8.1
|
136
142
|
report.value "mechanistic_basis","<html><head></head><body>
|
137
143
|
<p>
|
138
|
-
Compounds with similar structures (neighbors) are assumed to have
|
139
|
-
similar activities as the query compound. For the determination of
|
140
|
-
activity specific similarities only statistically relevant subtructures
|
141
|
-
(paths) are used. For this reason there is a priori no bias towards
|
144
|
+
Compounds with similar structures (neighbors) are assumed to have
|
145
|
+
similar activities as the query compound. For the determination of
|
146
|
+
activity specific similarities only statistically relevant subtructures
|
147
|
+
(paths) are used. For this reason there is a priori no bias towards
|
142
148
|
specific mechanistic hypothesis.
|
143
149
|
</p>
|
144
150
|
</body>
|
@@ -148,22 +154,22 @@ report.value "mechanistic_basis","<html><head></head><body>
|
|
148
154
|
report.value "mechanistic_basis_comments","a posteriori for individual predictions"
|
149
155
|
|
150
156
|
# Other information about the mechanistic interpretation 8.3
|
151
|
-
report.value "mechanistic_basis_info","<html><head></head><body><p>Hypothesis about biochemical mechanisms can be derived from individual
|
157
|
+
report.value "mechanistic_basis_info","<html><head></head><body><p>Hypothesis about biochemical mechanisms can be derived from individual
|
152
158
|
predictions by inspecting neighbors and relevant fragments.</p>
|
153
|
-
<p>Neighbors are compounds that are similar in respect to a certain
|
154
|
-
endpoint and it is likely that compounds with high similarity act by
|
155
|
-
similar mechanisms as the query compound. Links at the webinterface
|
156
|
-
prove an easy access to additional experimental data and literature
|
159
|
+
<p>Neighbors are compounds that are similar in respect to a certain
|
160
|
+
endpoint and it is likely that compounds with high similarity act by
|
161
|
+
similar mechanisms as the query compound. Links at the webinterface
|
162
|
+
prove an easy access to additional experimental data and literature
|
157
163
|
citations for the neighbors and the query structure.</p>
|
158
|
-
<p>Activating and deactivating parts of the query compound are highlighted
|
159
|
-
in red and green on the webinterface. Fragments that are unknown (or too
|
160
|
-
infrequent for statistical evaluation are marked in yellow and
|
161
|
-
additional statistical information about the individual fragments can be
|
162
|
-
retrieved. Please note that lazar predictions are based on neighbors and
|
163
|
-
not on fragments. Fragments and their statistical significance are used
|
164
|
+
<p>Activating and deactivating parts of the query compound are highlighted
|
165
|
+
in red and green on the webinterface. Fragments that are unknown (or too
|
166
|
+
infrequent for statistical evaluation are marked in yellow and
|
167
|
+
additional statistical information about the individual fragments can be
|
168
|
+
retrieved. Please note that lazar predictions are based on neighbors and
|
169
|
+
not on fragments. Fragments and their statistical significance are used
|
164
170
|
for the calculation of activity specific similarities.</p>"
|
165
171
|
|
166
|
-
# Reference all publications to the bibliography
|
172
|
+
# Reference all publications to the bibliography
|
167
173
|
# Bibliography 9.2
|
168
174
|
report.ref_catalog :bibliography, :publications_catalog, :publications_catalog_1
|
169
175
|
report.ref_catalog :bibliography, :publications_catalog, :publications_catalog_2
|
@@ -172,4 +178,4 @@ report.ref_catalog :bibliography, :publications_catalog, :publications_catalog_3
|
|
172
178
|
|
173
179
|
# output
|
174
180
|
response['Content-Type'] = "application/xml"
|
175
|
-
return report.to_xml
|
181
|
+
return report.to_xml
|
metadata
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: qsar-report
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.0.
|
4
|
+
version: 1.0.1
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Micha Rautenberg
|
@@ -107,8 +107,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
107
107
|
- !ruby/object:Gem::Version
|
108
108
|
version: '0'
|
109
109
|
requirements: []
|
110
|
-
|
111
|
-
rubygems_version: 2.5.1
|
110
|
+
rubygems_version: 3.0.6
|
112
111
|
signing_key:
|
113
112
|
specification_version: 4
|
114
113
|
summary: qsar-report
|