Installation¶

Installation From Release¶

pyNastran is an easy package to install once you have the required Python modules. It’s a pure Python package so you shouldn’t have too many problems. Just type on the command line:

pip install pyNastran

That will install the minimum set of what you need to run pyNastran (so no GUI). If you want GUI functionality, chances are you have PyQt5 or PySide2, but don’t have vtk. Vtk is a bit more challenging on Windows, but there is website to help with that.

Additionally, the software can optionally use matplotlib, pandas, h5py, colorama, but chances are you already have those. If you don’t, they’re very easy to install.

Python¶

The software is tested on Windows and Linux against:

Python 3.7

Python 3.8

Python 3.9 (availible in pyNastran 1.3.4)

Python 3.10 (availible in pyNastran 1.3.4)

Packages¶

pyNastran is tested against a range of package versions (lowest to highest based on availbility), so it should work. The recommended set of packages are:

Required:

numpy >= 1.14

scipy >= 1.0

cpylog >= 1.4.0

docopt-ng == 0.7.2 (required for command line tools)

Optional:

colorama >= 0.3.9 (colored logging)

pandas >= 0.25

matplotlib >= 2.2.4 (plotting)

h5py >= 2.8.0 (HDF5 support)

GUI:

vtk >= 7 (vtk=9 has some warnings)

qtpy >= 1.4.0

Qt (pick one)

PyQt5 >= 5.9.2

PySide2 >= 5.11.2

PyQt6

PySide6

QScintilla >= 2.13.0 (optional for fancy scripting; PyQt5/6 only)

pygments >= 2.2.0 (optional for fancy scripting; PyQt5/6 only)

imageio >= 2.4.1,<3 (optional for animation support)

Install Procedure - From Regular Python (recommended)¶

Base functionality:

64-bit Python

pip install numpy

pip install scipy

pip install pandas (optional)

pip install h5py (optional for HDF5 support)

pip install matplotlib (optional for plotting)

pip install colorama (optional for colored logging)

pip install docopt-ng (required for command line tools)

pip install cpylog

pip install pyNastran

For optional GUI support:

On the command line:

pip install imageio (optional for animation support)

pip install pyside2

pip install vtk

pip install qtpy

Additional source for Windows binaries

pip install VTK*.whl

Use Web docs¶

See docs

Installation From Source¶

pyNastran is an easy package to install once you have the required Python modules. It’s a pure Python package so you shouldn’t have too many problems.

Installing from source is recommened if:

You want the most recent version (see installation.rst-main)
You want easier access to the source
You’re on an air-gapped machine

Install Python (see installation_release)

skip the pip install pyNastran step

Install Sphinx, GraphViz, alabaster (for documentation)

Install Git

Clone pyNastran-main from Github

Install pyNastran

Install GraphViz

Install additional python packages

pip install Sphinx
pip install alabaster
pip install numpydoc

Download & install Git

Download a GUI for Git (optional)

TortoiseGit (recommended for Windows)

There are two ways to install the 1.3 (main/dev) version of pyNastran

Download the most recent zip version

Clone pyNastran (see below). Using Git allows you to easily update to the latest dev version when you want to as well as push any commits of your own.

If you don’t want the gui, use setup_no_gui.py instead of setup.py.

>>> python setup.py install

or:

>>> python setup_no_gui.py install

Right-click in a folder and select Git Clone.

Enter the above information. If desired, click the branch box and and enter a branch name and click OK.

Checkout/clone the dev code by typing (preferred):

>>> git clone https://github.com/SteveDoyle2/pynastran

To checkout a branch

>>> git.exe clone --branch 1.3 --progress -v "https://github.com/SteveDoyle2/pyNastran.git" "C:\\work\\pyNastran_1.3"

Two options for documentation exist.

Build Docs¶

Navigate to pyNastran/docs_sphinx directory on the command line.

>>> make html