You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+71-12Lines changed: 71 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,30 +1,58 @@
1
-
<palign="center">
2
-
<imgalt="A splash image for installation script."width="480px"height="182px"src="https://user-images.githubusercontent.com/52927689/218594750-e8f8009f-d60e-4e51-872a-eb274e0709a1.png">
3
-
</p>
4
-
5
-
# OpenVnmrJ_WSL
6
-
<ahref="https://github.com/OpenVnmrJ/OpenVnmrJ">OpenVnmrJ</a> is free and open-source software for processing NMR spectroscopy data. It runs on Ubuntu 20.04 and Red Hat 7.5+ & 8+ based Linux ditributions as well as macOS 10.13+. This Powershell script is used to install and configure Windows Subsystem for Linux and OpenVnmrJ on Windows 10+ as an alternative to installing within a virtual machine. WSL provides a native application experience and can result in a smaller installation footprint and faster application startup times.
<img alt="A splash image for installation script." width="640px" height="240px" src="https://user-images.githubusercontent.com/52927689/218879398-e6befea4-01cf-439a-aa2a-3937209f552b.png">
4
+
</a>
5
+
</h1>
6
+
7
+
<divalign="center">
8
+
<ahref="https://github.com/JessiBaughman/OpenVnmrJ_WSL/issues/new?assignees=&labels=bug&template=01_BUG_REPORT.md&title=bug%3A+">Report a Bug</a>
9
+
</div>
10
+
11
+
[](LICENSE)
12
+
<detailsopen="open">
13
+
<summary>Table of Contents</summary>
14
+
15
+
-[About](#about)
16
+
-[Getting Started](#getting-started)
17
+
-[Prerequisites](#prerequisites)
18
+
-[Administer Privileges](#administer-privileges)
19
+
-[Windows version](#windows-version)
20
+
-[BIOS](#bios)
21
+
-[Windows Features](#windows-features)
22
+
-[Usage / Running the script](#usage--running-the-script)
23
+
-[Running OpenVnmrJ](#running-openvnmrj)
24
+
-[Launching OpenVnmrJ](#launching-openvnmrj)
25
+
-[Printing / Plotting](#printing--plotting)
26
+
-[Closing OpenVnmrJ](#closing-openvnmrj)
27
+
-[License](#license)
28
+
29
+
</details>
30
+
31
+
## About
32
+
<ahref="https://github.com/OpenVnmrJ/OpenVnmrJ">OpenVnmrJ</a> is free and open-source software for processing NMR spectroscopy data. It runs on Ubuntu 20.04 and Red Hat 7/8 based Linux ditributions as well as macOS 10.13+. This Powershell script is used to install and configure Windows Subsystem for Linux and OpenVnmrJ on Windows 10+ as an alternative to installing within a virtual machine. WSL provides a native application experience and can result in a smaller installation footprint and faster application startup times.
7
33
8
34
<p>
9
35
<br />
10
36
</p>
11
37
12
-
## Prerequisites
38
+
## Getting Started
39
+
40
+
### Prerequisites
13
41
14
-
### Administer Privileges
42
+
####Administer Privileges
15
43
Some parts of the script will require administrator privileges to install, configure, or update. You will be prompted on the secure desktop each time.
16
44
17
-
### Windows version
45
+
####Windows version
18
46
To find your version of Windows, open the Settings panel (`Windows + I`) and navigate to System->About.
19
47
20
48
***Windows 10** : Version 2004 (aka 20H1, Build 19041, released Spring 2020) or later
21
49
22
50
***Windows 11** : Version 21H2 (Build 22000, released Fall 2021) or later
23
51
24
-
### BIOS
52
+
####BIOS
25
53
You will need to enable virtualization in your system BIOS. Entering the BIOS configuration at boot and the label of the virtualization setting itself varies between motherboard manufacturers. You may be able to find detailed instructions by searching your computer model number or manufacturer's name.
26
54
27
-
### Windows Features
55
+
####Windows Features
28
56
<palign="center">
29
57
<imgalt="The Windows Features panel"width="415px"height="368px"src="https://user-images.githubusercontent.com/52927689/218584527-d098fb02-ded6-4171-98bf-a67fd5db776a.png">
30
58
</p>
@@ -34,7 +62,7 @@ Two features need to be installed and activated within Windows. These are the "V
34
62
<br />
35
63
</p>
36
64
37
-
##Installation / Running the script
65
+
### Usage / Running the script
38
66
39
67
1.**Unlock the script**
40
68
- Right-click on the .ps1 file and click Properties. Check to see if there is a section at the bottom that reads, "Security: This file came from another computer and might be blocked to help protect this computer." If so, click the Unblock checkbox and click OK.
@@ -92,3 +120,34 @@ Two features need to be installed and activated within Windows. These are the "V
92
120
10.**Press Enter to close the Powershell window**
93
121
- An installation log is not automatically saved. If you wish to save a log, copy the Powershell contents before pressing Enter.
* Print to file commmands will work as expected. File paths are within Ubuntu, so to save to Windows, navigate to `/mnt/c` to access the `C:` drive.
137
+
* Output created using the `plot` command will be sent to the PDF printer and saved to the directory selected during install.
138
+
<palign="center">
139
+
<imgalt="Printer selection within the Plot panel of OpenVnmrJ"width="373px"height="248px"src="https://user-images.githubusercontent.com/52927689/218859889-5975e8e9-df79-45da-8329-e5b5aa3340c4.png">
140
+
</p>
141
+
142
+
* You can toggle between color and grayscale plots by selecting the corresponding version of the PDF printer either from the File->Printers... window or the "Send to" drop-down menu within the Processing->Plot panel.
143
+
144
+
### Closing OpenVnmrJ
145
+
* OpenVnmrJ can be exited in the standard methods
146
+
* File->Exit VnmrJ, close the window, or type `exit` on the command line
147
+
***Windows 10:** Once closed, you will need to manually exit VcXsrv from the taskbar if desired.
148
+
149
+
## License
150
+
151
+
This project is licensed under the **MIT license**. Feel free to edit and distribute this template as you like.
0 commit comments