Package: dp4plus-app
DP4+ AppThis repository contains the tool presented in the publication titledDP4+App: Finding the Best Balance between Computational Cost and Predictive Capacity in the Structure Elucidation Process by DP4+. Factors Analysis and Automation, published in the Journal of Natural Products on September 18, 2023.For all work usingDP4+Appplease cite the primary publication:_J. Nat. Prod. 2023, 86, 10, 2360â€“2367 .https://doi.org/10.1021/acs.jnatprod.3c00566A tool for DP4+, MM-DP4+ and Custom DP4+ probability calculationTheDP4+Appis a powerful tool designed to assist researchers in the structure elucidation process by balancing computational cost and predictive capacity using DP4+ factors analysis and automation. It provides valuable insights and streamlines the decision-making process, making it a valuable asset for chemists and researchers working in natural product chemistry and related fields.This is a comprehensive software was designed to facilitate DP4+ and MM-DP4+ calculations. With its user-friendly graphical interface, users can seamlessly handle multiple Gaussian calculations and leverage automated data processing for accurate probabilistic analysis. The software offers the flexibility to perform Custom-DP4+ calculations, enabling parameterization of theory levels as per individual requirements.CharacteristicsFunctionalitiesTheDP4+ Apputilizes advanced calculation methods to determine the probability of correlation between experimental information and two or more sets of calculated magnetic tensors from a group of candidate molecules under study. These probabilities are determined using both raw and scaled data, following the mathematical formalism of Bayesian methods.To perform a calculation, you need to provide the one-dimensional spectrum of the carbon (C) and/or hydrogen (H) atoms of the molecule you are studying, along with the Gaussian "nmr" calculations of its plausible isomers (candidates).It is important to note that the theory level used in the Gaussian calculations must match the level used in the DP4+ App. To accommodate various requirements, the software offers a wide range of options, including 24 DP4+ levels, 36 MM-DP4+ levels, and, if needed, the ability to parameterize your own custom level using Custom DP4+. For detailed information about the available functions and levels, please refer to theDP4+ App user guideInstallation RequirementsTo run the DP4+ App, you will need Python 3.8 or a later version. If you don't have Python installed on your system, you can download it fromhttps://www.python.org/downloads/.Please make sure to add Python to your system's PATH environment variable to ensure correct usage of the DP4+ App. The following steps explain how to enable Python in your system's PATH:Download and install Python from the provided link.During the installation process, you will come across an option called "Add Python to PATH" or something similar. Make sure to check this option before proceeding with the installation.By enabling this option, Python will be added to your system's PATH, allowing you to run Python commands and scripts from any location in your command prompt or terminal.By following these instructions and ensuring Python is correctly added to your system's PATH, you will be able to use the DP4+ App without any issues.Install DP4+AppTo get started with theDP4+ App, you can choose from two installation methods:Running the Installer Script:Install the DP4+ App by running the provided installer script available atDP4+App_Installer. Simply save the code by opening it in raw format and right-clicking on the website screen to choose "Save as". Then, run the saved script on your system.Using the OS Console (Command Line):Alternatively, you can install theDP4+Appby executing the following command in your operating system's console (command line):pip install dp4plus-appLinux (Ubuntu) users be aware that Python moduletkinteris not installed withpipin your OS. In case your want to installDP4+ Appby command line, make sure to also install tk with  >sudo apt-get install python3-tk. If you prefer the installer script, this issue is already addressed within it.Choose the installation method that suits you best, and you'll be ready to use the DP4+ App for your probabilistic analysis needs.Running DP4+AppOnce you have successfully installed the DP4+ App, you can execute it using the following methods:If you have installed the program via the command line, you can run it directly in the same console by using the command:dp4plusIn case you have used theDP4+App_Installeris used, the program can be executed either through the command line or by double-clicking on the shortcut nameddp4plus.exethat has been created on your desktop.If the executable is missing or not created yet, thedp4plus.exeshortcut can be generated using command line:dp4plus-exeUser Guide and ExamplesTo help you get started with the DP4+ App and learn how to use its features effectively, we provide a comprehensiveDP4+ App user guide. It is available in the repository and can also be accessed directly within the program by clicking on theUser Guidebutton.The user guide offers detailed instructions, explanations, and step-by-step tutorials to assist you in navigating the DP4+ App and making the most of its functionalities. It serves as a valuable resource to enhance your understanding of the tool and perform accurate probabilistic analyses.Additionally, within the DP4+ App, you will find a corroborated study case that serves as an example. This study case demonstrates how to utilize the tool effectively, providing practical insights into its usage and showcasing its capabilities.By referring to the user guide and exploring the example study case, you can quickly familiarize yourself with the DP4+ App and gain confidence in performing probabilistic analyses for your research or projects.Bugs and malfuntionsIf you encounter any issues or experience faulty operations while using theDP4+App, we encourage you to report your situation in detail. By providing comprehensive information about the problem, you can assist us in improving the software. Please reach out to us using the following email addresses:brunoafranco@uca.edu.arzanardi@inv.rosario-conicet.gov.arsarotti@iquir-conicet.gov.arWhile you have the option to comment in this repository, we recommend using the email addresses mentioned above, as we monitor them more frequently.F.A.Q.How can I uninstall DP4+App ?In your terminal run the code:pip uninstall dp4plus_apporpip3 uninstall dp4plus_appWhy I get this error:pip is not recognized as an internal or external command, operable program or batch file.?This error occurs when the pip command or any other command is not recognized in the terminal. It typically happens when the required executable modules are not included in the system's PATH list.To resolve this issue, you have a couple of options:Reinstall Python, ensuring that you enable the option to add it to your computer's PATH during the installation process.Manually add the appropriate directories to the PATH environment variable on your computer. This will involve modifying the system settings and adding the paths of the required executable modules. You can find step-by-step instructions on how to do this in the following resources:Link 1yLink 2Â¿ ... ?