You can install Q3 in two methods: The first is based on the paclet
system that has recently been introduced by Wolfram Research. It is not only fully automatic but also convenient to get updates later on. The other method is to download and copy the files to a proper folder -- just the traditional method.
Q3 supports the paclet mechanism of Mathematica packages. It allows remote installation and update. To install remotely, please follow these steps:
-
First, make sure to remove the old copy of
Q3
that you manually installed (older thanQ3 v1.5.1
), and restart your Mathematica. Note also that this method requires Mathematica v12.2 (or later). -
Copy the following code, and run it on your Mathematica front end (Notebook interface).
Module[ { ps }, ps = PacletSiteRegister[ "https://github.com/quantum-mob/PacletRepository/raw/main", "Quantum Mob Paclet Server" ]; PacletSiteUpdate[ps]; PacletInstall["Q3"] ]
That's all!
Once installed (using the automatic installation method), Q3 will automatically check for updates and install the newest update (if any). This feature has been introducted in v1.7.3. If you have an older version, you have to manually update Q3 to the most recent one (see the instruction below).
If you want to check for updates and install them manually, follow these instructions:
-
You can check for updates of Q3 by the following command.
Q3CheckUpdate[]
-
When a newer release is available on the server, you can install it with this command.
Q3Update[]
You may like to give an option
ForceVersionInstall->True
toQ3Update
. See the Help Documentation forQ3Update
for more details.
If you do not want Q3 any longer, then you can uninstall it by evaluating the following code:
PacletUninstall["Q3"]
You can download a paclet archive file, and install Q3 from it.
-
Get a paclet archive file of Q3 from the Releases. Each release has the "Assets" section, which includes a paclet archive file (with file extension ".paclet" such as "Q3-3.8.2.paclet"), zip source file and tar.gz source file.
-
Put it in one of the folders in the search path (see Mathematica built-in symbol
$Path
as well as functionSetDirectory
). -
On Mathematica, execute
PacletInstall[File["<filename>"]]
Replace
<filename>
in the above with the filename of the paclet archive file (enclosed in the quotation marks). -
Check your installation.
PacletFind["Q3"]
If you want to try a beta version of Q3, which might be buggy, following the following steps:
-
Download the whole folder as a ZIP file.
-
Unzip the ZIP file to extract the files and subfolders.
-
Move (or copy) the folder Q3 to either
$UserBaseDirectory/Applications/ (recommended)
or
$BaseDirectory/Applications/
Here,
$UserBaseDirectory
is a Mathematica(R) symbol, the value of which you can check on your Mathematica.