Git Product home page Git Product logo

matlab-jsystem's Introduction

matlab-jsystem

A fast drop-in replacement for matlab's system command.

Ever need to run a shell command or external process from matlab code? Using matlab's built in system command can be extremely slow, causing severe overhead if you're calling it many times. jsystem is a drop-in replacement for system which is both much faster and also has some extra convenience features.

Usage

  • Run any shell command:

    >> [res, out] = jsystem('ls -R')
    res =
         0
    out =
         LICENSE.md
         README.md
         src
    
         ./src:
         jsystem.m
    
  • Use shell built-ins, pipes and redirects:

    >> [res, out] = jsystem('echo "YES" && ls -al | grep src > /dev/null')
    res =
         0
    out =
         YES
    
  • Specify your own custom shell to use:

    >> [res, out] = jsystem('echo "My shell is $SHELL"', '/usr/local/bin/zsh')
    res =
         0
    out =
         My shell is /usr/local/bin/zsh
    
  • Execute a program directly, without a shell (even faster, since there's no shell startup overhead)

    >> [res, out] = jsystem('/usr/bin/du -h ./src', 'noshell')
    res =
         0
    out =
         4.0K   ./src
    

Benchmarks

Run the included benchmarks in test/jsystem_benchmak.m to get an indication of the speedup you can expect to see when using jsystem. Here's a representative result (on my machine - late 2012 macbook pro).

  • jsystem vs matlab's built-in system:

    Benchmark #1 - Command: "echo OK > /dev/null", 50 iterations
    system: 17.000 [ms] average
    jsystem: 3.400 [ms] average

  • jsystem with and without a shell

    Benchmark #2 - Command: "/bin/ls -al", 50 iterations
    jsystem: 3.600 [ms] average
    jsystem (noshell): 2.600 [ms] average

Contributing

PRs would be greatly appreciated.

License

MIT.

matlab-jsystem's People

Contributors

avivrosenberg avatar

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.