qsar-report 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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
|