Giter Club home page Giter Club logo

ensnano's Introduction

ensnano-logo

This is an archived repository. ENSnano's new repository can be found at https://github.com/ensnano/ensnano

About

ENSnano is a software for designing DNA nanostructures.

ENSnano takes up the concepts of existing DNA nanostructures design softwares such as cadnano and extends them with additional features. Notable features of ENSnano include

  • A 3D editable view synchronized with a 2D cadnano-like interface
  • 3D and 2D cross-over recommendations based on the structure's geometry
  • An interactive and geometry aware copy and paste functionality

Currently, ENSnano can only produces sequences for DNA origamis.

For more details about ENSnano you can checkout the paper introducing it in the proceedings of the DNA27 conference:

ENSnano: a 3D modeling software for DNA nanostructures Nicolas Levy and Nicolas Schabanel. DNA 2021 Proceedings of the 27th International Conference on DNA Computing and Molecular Programming [ pdf ]

You can also see here the talk presented at the conference.

Installation

We try to frequently release binaries for Windows and MacOS.

Alternatively you can clone this repository and build the software from source, following instructions below:

Dependencies

All platforms

You need to have the latest Rust compiler installed. See this page.

Note: If you already have Cargo installed but face compilation issues, make sure that you have the latest version by running

rustup update

Linux

You need the GTK3 development packages and a C++ compiler to build the RFD dependency.

  • Debian/Ubuntu: apt-get install build-essential libgtk-3-dev

  • Fedora: dnf install gtk3-devel

  • Archlinux: pacman -S gtk3

You also need to have the Vulkan driver for your graphic card installed. The installation method depends on your distribution and graphic card, but there should be a tutorial on the internet for any combination of those.

Compiling from source

Clone the repository:

git clone https://github.com/thenlevy/ensnano.git

Then run ENSnano with:

cd ensnano
cargo run --features=log_after_renderer_setup --release

Importing Cadnano/Scadnano files

ENSnano does not currently handles deletions/loops/insertions in its designs. Here is how these features are handled when importing a cadnano/scadnano file

  • The nucleotides that are "deleted" are removed from the design
  • Insertions are replaced by a single strand on an attributed helix

Example

In this cadnano design, deleted nucleotides are removed and loops are replaced by single strands

cadnano_del_loop ensnano_del_loop

In this scadnano design, insertions and loopouts are replaced by single strands

scadnano_insert_loopout ensnano_insert_loopout

Troubleshooting

Compilations errors

Compilation errors may be happen when using an outdated version of the rust compiler. To solve this run

rustup update

It might also happen that you need to update ENSnano's dependencies before compiling. To do so, run

cargo update

Crash at startup on Windows

By default, ENSnano uses a Vulkan renderer on windows platforms that offers one. However this renderer does not work properly on some machines. For this reason it is also possible to use a DirectX12 renderer instead.

If your program crashes on startup, try using the binary

ensnano-windows-dx12

or, if you are compiling from source, use a DirectX12 renderer with

cargo run --release --features="dx12_only log_after_renderer_setup"

Third-party licenses

The licenses of the dependencies are listed in thirdparties/license.html

This software uses the following fonts which are distributed under the SIL OpenFont License

The font font/DejaVuSansMono.ttf is in public domain.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.