Installation Guide

About 1592 wordsAbout 5 min

1. Machine Configuration Requirements

Operating System	Windows 11 Professional
CPU	Intel i7-8700 or above
Memory	16G or above
GPU	NVIDIA RTX 3050 or above (driver version 525 or above)
Hard Drive	128 GB SSD or above (free space on the C drive)

2. Installation Package Download

2.1 Download Methods

NAS is the company's file server. You can contact the company's IT department to apply for a NAS account.

After logging in to NAS, navigate to the PickWiz installation package storage directory:

Find the required software version in the pickwiz_release folder.

After opening the windows directory, you can see the following file list:

2.2 Description of Installation Package Types

Full Installation Package & Full Upgrade Package

The full installation package is named PickWiz_v{X.Y.Z}_win_x64_offline.zip, which contains the PickWiz application, the basic Deep Learning environment, and general models, as shown below.
The full upgrade package is named PickWiz_v{X.Y.Z}_win_x64_upgrade_offline.zip, which contains the PickWiz application and general models, with the basic environment-related resources removed. If the basic environment has already been prepared using the full offline package, you can use the offline upgrade package for later upgrades (smaller size).

The full installation package and full upgrade package support fully offline installation.

3. Install the Software

3.1 Installation on a New Machine

The full installation package and full upgrade package support fully offline installation.

Checks required before installation:
When installing and updating PickWiz using the full installation package, Anaconda does not need to be installed;
If Anaconda is already installed but is located in a folder that requires administrator permissions (such as the Windows folder on the C drive, Program Files, Program Files (x86), ProgramData, etc.), or if the environment variables are configured incorrectly, uninstall the installed Anaconda first and delete the corresponding environment variables. Also ensure that Anaconda is not installed in the PickWiz installation directory (for example, C:\Users\dex);
If 360 antivirus software is installed before installation, close it first; otherwise, it may block the installer.

（1） Extract the full installation package

（2） Install PickWiz

Open the extracted files and double-click the exe application file, as shown below;

Select the installation directory
It is recommended to install it in the default directory. It cannot be installed on another hard drive.
Follow the prompts until you reach "Select Components"
When the installation progress reaches 95%, a prompt saying "Installing component middleware" will appear.
When installing PickWiz for the first time on a new machine, the CUDA installation window will pop up. The image below shows the temporary CUDA extraction directory. It is recommended to use the default folder. This folder will be deleted automatically after installation is complete.
For "Installation Options", it is recommended to choose "Compact".
CUDA installation completed
PickWiz installation continues. The first installation takes about 30 minutes. Please wait patiently. After installation is complete, the following prompt will appear:
Click "Next" to complete the installation.
After installing PickWiz for the first time, restart the computer before running PickWiz

3.2 Upgrade

To upgrade using the full upgrade package, refer to 3.1 Install Using the Full Installation Package

3.3 Install `whl` Packages Separately

For installing whl packages such as PickLight, GLIA, and RLIA.

Download the whl package from NAS. For the NAS address, refer to 2.1 Download Methods

Navigate to the directory of the required whl package and download it.

After downloading, open the Anaconda Prompt terminal.

In the opened Anaconda Prompt terminal, enter the conda activate pickwiz_py39 command to activate the backend environment.

Enter the command to the directory where the downloaded whl package is saved. Usually, after downloading, the whl package is saved in the C:\Users\Administrator\Downloads directory, so enter Downloads in the Anaconda Prompt terminal to reach the directory where the whl package is stored.

In the directory where the whl package is stored, run the installation command pip install xxx.whl, where xxx.whl indicates the package name.

If you install a whl package of the same version, run the pip uninstall xxx.whl command to uninstall it first, and then run the installation command pip install xxx.whl; otherwise, the whl package installation may fail.

4. Uninstall the Software

（1） Uninstall using the uninstaller

Open the PickWiz installation directory. For the installation directory, refer to the "Select the installation directory" step in 3.1 Installation on a New Machine
Find the application named MaintenanceTool.exe
Double-click the MaintenanceTool application to enter the "Maintain PickWizSetup" window, and select "Remove all components"
Click "Uninstall" to complete PickWiz uninstallation.

（2） Uninstall using Control Panel

Open "Control Panel" from the Start menu, and click "Uninstall a program"
Find the PickWiz program, right-click it, and click "Uninstall"
Enter the "Maintain PickWizSetup" window, and select "Remove all components"
Click "Uninstall" to complete PickWiz uninstallation.

5. Software License Agreement

Open the PickWiz installation directory and enter the folder named Licenses to view the PickWiz software license agreement.

6. Common Installation Issues

Issue Category	Issue Description	Possible Cause	Solution
Operating System	Error when opening PickWiz: `Open3D.dll` not found	The device's operating system does not meet the machine configuration requirements	Upgrade the device's operating system to Windows 11 Professional
GPU	Error when opening PickWiz: `RLIA.dll` and `Open3D.dll` not found	The device graphics card does not meet the machine configuration requirements	Graphics card requirement: NVIDIA GTX 1660 or above (driver version 525 or above)
	Error during installation: "No available graphics card detected. Installation cannot continue."	Graphics card missing	1. Restart the computer; 2. Update the driver: find Display Adapters in Device Manager, right-click the NVIDIA graphics card, and click Update Driver;3. Open the machine and check whether the graphics card is seated properly. If it is loose, reinsert it firmly.
	Error when running PickWiz: "The system did not detect an available graphics card. Please try restarting the computer / updating the driver, and check whether the graphics card is seated properly."	Graphics card missing	1. Restart the computer; 2. Update the driver: find Display Adapters in Device Manager, right-click the NVIDIA graphics card, and click Update Driver;3. Open the machine and check whether the graphics card is seated properly. If it is loose, reinsert it firmly.
Hard Drive	Error during installation: `no space left`	Insufficient free space on the C drive	Reinstall the operating system, and install again when the C drive has more than 128GB of free space. Note: it cannot be installed on the D drive or other hard drives.
Restart	Error when opening PickWiz: `RLIA.dll`, `Open3D.dll`, `vtklmagingCore-9.2.dll`, and `pcl_kdtree.dll` not found	When installing PickWiz for the first time, the device must be restarted for environment variables to take effect	Restart the device. Note: after restarting, the first time you open PickWiz, the loading speed will be slower. Please wait patiently.
Middleware installation error (`middleware` is a git directory, please remove the git directory)		`middleware` and `PickLight` folders must be completely deleted	1. Use the Anaconda Prompt terminal to open `conda activate pickwiz_py39` 2. Enter `pip show middleware` to find the `site-packages` directory 3. Delete the `middleware` and `PickLight` folders and their `info` folders in `site-packages`, or continue in the Anaconda Prompt terminal by running the `pip uninstall middleware` and `pip uninstall PickLight` commands to delete them as well
Full installation package missing compressed files	When upgrading PickWiz 1.5 to PickWiz 1.7.3 with the full installation package, the installation fails.	The downloaded full installation package is missing two compressed filesA normal full installation package contains 4 compressed files in this directory	Download the full installation package again