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.
Files changed (5) hide show
  1. checksums.yaml +5 -5
  2. data/README.md +10 -5
  3. data/VERSION +1 -1
  4. data/example/example.rb +38 -32
  5. metadata +2 -3
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
- SHA1:
3
- metadata.gz: ce30ac63bbaf020f63235fa93c3212d86aa9c9e5
4
- data.tar.gz: 600db077192a3c44e992b38ca5ebd6ed2309ca0b
2
+ SHA256:
3
+ metadata.gz: 104056a6f62296b06a038eb182a983b5ec6629c66a0f76cebffcabefc49a6f2c
4
+ data.tar.gz: d8afaccbf23bbf7691503111046201bffcf9bbe54170c04d52bcd1cc8eb6b864
5
5
  SHA512:
6
- metadata.gz: 0c3cb1f615ce87565f03169b071a198a401add81c9192d747b1f7933030392748b26bebe21c6a3a172362c7b462c5bdcc5340e610d25481befb2abd4c60be9c6
7
- data.tar.gz: 01b3f2ee0ecd3fb2e0a3a852dc2263434e7d50e8bf3a4ebd64fbb4a88fe7fa16ec9c849c50aff546b9f10861f1451da0f4b457ccb7db96598a8743cfd5d92e88
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
- Class for QMRF and QPRF reporting.
5
- * QMRF:
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
- * QPRF:
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
- gem install qsar-report
74
+ gem install qsar-report
70
75
 
71
76
  Documentation
72
77
  -------------
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.0.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.1
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.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
- rubyforge_project:
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