Difference between revisions of "Jreader"
From NMReDATA
(update links to new server at UAH) |
|||
| (6 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | |||
| − | [ | + | [https://NMReDATA.web.uah.es/reader/reader.htm ''J_reader''] is a webtool for reading and editing NMReDATA files that can be accessed through the web or [[Jreader#Installation |installed]] on a local computer. |
| − | In both cases, the | + | In both cases, the program is running on the users's computer. No data (structure, etc.) are sent to any server via the net. |
| + | |||
| + | '''This page is under construction and will be improved...''' | ||
=== Main features === | === Main features === | ||
| − | * | + | *Display the structure(s) |
| − | * | + | *Display the data in the signal assignment tags (NMREDATA_ASSIGMENT) |
| − | * | + | *Display the data in the J-coupling assignment tags (NMREDATA_J) |
| − | * | + | *For each NMREDATA_1D tag, display the 1D spectrum if available in JCAMP format; additionally, the data found in the tag (chemical shifts, couplings) are displayed on top of the structure display. |
| − | * | + | <!-- |
| + | *For each NMREDATA_2D tag, display the 2D spectrum (pop-up window) and add on top the spectral data found in the tag (list of correlations vertical and horizontal lines for each "label" and dits when the correlation was listed in the tag) | ||
| + | --> | ||
| + | |||
| + | This work was presented at the [[ Symposium2019 | 1st NMReDATA symposium in Sept. 2019]]. | ||
===2D to 3D conversion=== | ===2D to 3D conversion=== | ||
| − | JSmol can display 3D structures (<jmolSmiles text="example">aspirin</jmolSmiles>), but | + | JSmol can display 3D structures (<jmolSmiles text="example">aspirin</jmolSmiles>), but for now the NMReDATA .SDF files include "flat" structures. |
| − | + | J_reader allows to start from the 2D model, add the implicit hydrogens and generate an “optimized” 3D structure that may be added to the original NMReDATA file and later saved to disk. The assignments and couplings are remapped accordingly on the 3D model. | |
| − | |||
=== Installation === | === Installation === | ||
For local installation: | For local installation: | ||
| − | 1) | + | <!-- |
| + | 1) Download the last version of the [https://sourceforge.net/projects/jmol/files/ Jmol package] - testing was done with version 14.29.46 | ||
| + | |||
| + | : 1a) From the downloaded <code>Jmol-xx.xx.xx-binary.zip</code>, extract <code>jsmol.zip</code> | ||
| + | : 1b) From <code>jsmol.zip</code>, extract everything or just the needed parts (see below) | ||
| + | |||
| + | 2) Download [https://NMReDATA.web.uah.es/J_reader.1.0.zip the J_reader package] that contains [https://NMReDATA.web.uah.es/reader/reader.htm the web application] and ancillary files. Extract everything. | ||
| + | : This download does not include any of the sample files used for demonstration by the web application. | ||
| + | --> | ||
| + | Download [https://NMReDATA.web.uah.es/J_reader.1.0.zip the J_reader package] that contains a copy of [https://NMReDATA.web.uah.es/reader/reader.htm the web application] and ancillary files. Extract everything. | ||
| + | : This download uses JSmol, a part of the full [https://sourceforge.net/projects/jmol/files Jmol distribution], version 14.29.46. | ||
| + | : It does not include any of the sample files used for demonstration by the web application. | ||
| + | |||
| + | The files should be arranged according to this schema: | ||
| + | * <code>reader.htm</code> (the interface) | ||
| + | * <code>combined.js</code> (utilities; contains code from jsTree, jQueryModal, AlertifyJS) | ||
| + | * <code>combined.css</code> (ditto) | ||
| + | * <code>img/</code> icons used in the page | ||
| + | * <code>JSmol.min.js</code> (main file of the JSmol library) | ||
| + | * <code>php/jsmol.php</code> (a component from JSmol library) | ||
| + | * <code>js/JSmolJSV.js</code> (a component from JSmol library; other files in that folder are not needed) | ||
| + | * <code>j2s/</code> (components forming the JSmol library; includes about 1300 files and subfolders) | ||
| − | + | The application works well from a web server; from local disk, it will work at least in some browsers. When running locally, due to security policy of the browsers, loading of data files is restricted to the folder where the htm file is (sometimes it works as well for subfolders and parent folders). Additionally, some browsers will require setting internal parameters (in <code>about:config</code> or equivalent feature), like <code>security.fileuri.strict_origin_policy = false</code> or <code>privacy.file_unique_origin = false</code> | |
=== Funding === | === Funding === | ||
This development was funded, in part, by the University of Geneva, Gr. D. Jeannerat, in spring 2019. | This development was funded, in part, by the University of Geneva, Gr. D. Jeannerat, in spring 2019. | ||
| − | + | ||
| − | |||
=== Acknowledgements === | === Acknowledgements === | ||
We thank Marion Pupier for multiple examples of NMR records used for this work. | We thank Marion Pupier for multiple examples of NMR records used for this work. | ||
| + | |||
| + | <!-- | ||
=== Technical test pages === | === Technical test pages === | ||
| Line 36: | Line 62: | ||
[[jmol testpage2 | Demo page by Angel Herraez]]. | [[jmol testpage2 | Demo page by Angel Herraez]]. | ||
| + | --> | ||
Latest revision as of 20:28, 17 February 2024
J_reader is a webtool for reading and editing NMReDATA files that can be accessed through the web or installed on a local computer. In both cases, the program is running on the users's computer. No data (structure, etc.) are sent to any server via the net.
This page is under construction and will be improved...
Main features
- Display the structure(s)
- Display the data in the signal assignment tags (NMREDATA_ASSIGMENT)
- Display the data in the J-coupling assignment tags (NMREDATA_J)
- For each NMREDATA_1D tag, display the 1D spectrum if available in JCAMP format; additionally, the data found in the tag (chemical shifts, couplings) are displayed on top of the structure display.
This work was presented at the 1st NMReDATA symposium in Sept. 2019.
2D to 3D conversion
JSmol can display 3D structures (example), but for now the NMReDATA .SDF files include "flat" structures.
J_reader allows to start from the 2D model, add the implicit hydrogens and generate an “optimized” 3D structure that may be added to the original NMReDATA file and later saved to disk. The assignments and couplings are remapped accordingly on the 3D model.
Installation
For local installation:
Download the J_reader package that contains a copy of the web application and ancillary files. Extract everything.
- This download uses JSmol, a part of the full Jmol distribution, version 14.29.46.
- It does not include any of the sample files used for demonstration by the web application.
The files should be arranged according to this schema:
-
reader.htm(the interface) -
combined.js(utilities; contains code from jsTree, jQueryModal, AlertifyJS) -
combined.css(ditto) -
img/icons used in the page -
JSmol.min.js(main file of the JSmol library) -
php/jsmol.php(a component from JSmol library) -
js/JSmolJSV.js(a component from JSmol library; other files in that folder are not needed) -
j2s/(components forming the JSmol library; includes about 1300 files and subfolders)
The application works well from a web server; from local disk, it will work at least in some browsers. When running locally, due to security policy of the browsers, loading of data files is restricted to the folder where the htm file is (sometimes it works as well for subfolders and parent folders). Additionally, some browsers will require setting internal parameters (in about:config or equivalent feature), like security.fileuri.strict_origin_policy = false or privacy.file_unique_origin = false
Funding
This development was funded, in part, by the University of Geneva, Gr. D. Jeannerat, in spring 2019.
Acknowledgements
We thank Marion Pupier for multiple examples of NMR records used for this work.
