Netiquette · Download · News · Gallery · Homepage · DSSR Manual · G-quadruplexes · DSSR-Jmol · DSSR-PyMOL · DSSR Licensing · Video Overview· RNA Covers

Author Topic: Running DSSR on macOS  (Read 1254 times)

Offline lillytishkoff

  • non-commercial
  • with-posts
  • *
  • Posts: 1
    • View Profile
Running DSSR on macOS
« on: November 08, 2024, 01:36:12 am »
DSSR Download Issue

 received a license approval to download DSSR- Basic and when I downloaded, I received an error. The software is still not working (see screenshot). Please advise how I can fix.

Offline xiangjun

  • Administrator
  • with-posts
  • *****
  • Posts: 1650
    • View Profile
    • 3DNA homepage
Re: Running DSSR on macOS
« Reply #1 on: November 08, 2024, 06:46:53 pm »
Thanks for your interest in using DSSR. Your screenshot provides information that explains why you're having problems using DSSR.

You're on a macOS, and you have double-clicked the x3dna-dssr executable to run it. I can reproduce your case by installing x3dna-dssr under the ~/Downloads folder and double-clicking it. The error message is quite informative, by showing that x3dna-dssr is run, and immediately exit. Running x3dna-dssr without any options gives the following message:

Quote
missing required option: must specify -i=PDBFile/mmCIF

type: 'x3dna-dssr -h (or --help)' for further help
      'x3dna-dssr --citation' for preferred citation(s)

Time used: 00:00:00:00

That means DSSR is already successfully installed on your macOS. It is just that DSSR is a command-line (CLI) program, and you need a terminal window to run it. There are many online tutorials on how to get started using terminal on macOS. Here is one: Absolute BEGINNER Guide to the Mac OS Terminal. Once you are familiar with the terminal, running DSSR should be straightforward, as detailed in the User Manual.

Quote from: DSSR User Manual
The DSSR executable (x3dna-dssr for macOS and Linux, and x3dna-dssr.exe for Windows) is self-contained and does not rely on any third-party libraries. There is no need for any setup or configurations: type x3dna-dssr -h to verify your installation. Note that DSSR is a command-line program: you need a terminal window to run it.


If you're GUI-driven and do not want to use CLI at all, then you may find the following two resources helpful:


Best regards,

Xiang-Jun

« Last Edit: November 08, 2024, 06:55:36 pm by xiangjun »

Offline xiangjun

  • Administrator
  • with-posts
  • *****
  • Posts: 1650
    • View Profile
    • 3DNA homepage
Re: Running DSSR on macOS
« Reply #2 on: November 08, 2024, 09:30:04 pm »
As a follow up, please note that:

Quote
The CTV distributes DSSR Basic and Pro versions in zip format for macOS, Linux, and Windows. Each zip file contains a DSSR binary executable as well as the associated user manual.

Assuming basic command-line knowledge, users should be able to follow the instructions in the manual and reproduce reported results.

 

Funded by the NIH R24GM153869 grant on X3DNA-DSSR, an NIGMS National Resource for Structural Bioinformatics of Nucleic Acids

Created and maintained by Dr. Xiang-Jun Lu, Department of Biological Sciences, Columbia University