Installation

This guide covers the prerequisites and steps to install Tungsten and set up its dependencies.

Prerequisites

Neovim Version

• Neovim 0.8.0 or higher.

Lua Dependencies

• nvim-lua/plenary.nvim: Required for asynchronous job handling and utility functions.

System Dependencies

Tungsten relies on external tools to perform calculations and render plots. Depending on your preferred backend, ensure the following are installed:

Wolfram Backend (Default)

To use the Wolfram backend, you must install the Wolfram Engine and its scripting interface, WolframScript. See the Wolfram Engine installation guide for download and activation instructions.

Python Backend

The Python backend uses standard scientific libraries for calculations and plotting. You must have Python 3 installed along with the following packages:

• sympy: For symbolic mathematics and solving equations.
• numpy: For numerical arrays and math operations.
• matplotlib: For generating 2D and 3D plots.

You can install these dependencies via pip:

pip install sympy numpy matplotlib

Installation

Install Tungsten using your preferred Neovim plugin manager.

Using lazy.nvim

{
  "B1gum/Tungsten",
  dependencies = { "nvim-lua/plenary.nvim" },
  config = function()
    require("tungsten").setup({
        -- Configuration options
    })
  end
}

Using packer.nvim

use {
  'B1gum/Tungsten',
  requires = { 'nvim-lua/plenary.nvim' },
  config = function()
    require('tungsten').setup()
  end
}

Verification

To verify that Tungsten is correctly installed:

1. Open Neovim
2. Run the command :TungstenStatus
3. A status window should open, displaying the current job status (Tungsten: No active jobs) if you do not have any running jobs.

Alternatively, you can test a simple evaluation:

1. Type 1+1 in a buffer.
2. Visually select the text.
3. Run :TungstenEvaluate. The result 2 should be inserted.