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:

pip install pyNastran

Python

The software is tested against:
  • Python 2.7.15 (Windows/Linux)
  • Python 3.6 (Linux)
  • Python 3.7 (Windows/Linux)

Packages

The package requirements are slightly different depending on your version of Python, but the ones below will work on all supported versions. The set of packages include:

  • Required:
    • numpy >= 1.14
    • scipy >= 1.0
    • cpylog >= 1.0.2
    • docopt == 0.6.2 (required for command line tools)
    • typing >= 3.6.4 (python 2.7)
    • pathlib2 >= 2.3.0 (python 2.7)
  • Optional:
    • colorama >= 0.3.9 (colored logging)
    • pandas ???
    • matplotlib >= 2.2.4 (plotting)
    • h5py >= 2.8.0 (HDF5 support)
  • GUI:
    • vtk 7.1.1 or 8.1.1
    • qtpy >= 1.4.0
    • Qt (pick one)
      • PyQt4 >= 4.x
      • PyQt5 >= 5.9.2
      • PySide >= 1.2.1
      • PySide2 >= 5.11.2
    • QScintilla >= ??? (optional for fancy scripting)
    • pygments >= 2.2.0 (optional for fancy scripting)
    • imageio >= 2.4.1 (optional for animation support)

Install Procedure - From Base Python

Base functionality:
  • Windows * Download Windows x86-64 MSI installer
  • Linux/Mac Python * Make sure to get 64-bit Python.
  • On the command line:
    • pip install numpy
    • pip install scipy
    • pip install docopt
    • pip install colorama
    • conda install typing (Python 2.7)
    • conda install pathlib2 (Python 2.7)
    • pip install pandas (optional)
    • pip install h5py (optional for HDF5 support)
    • pip install matplotlib (optional for plotting)
    • pip install cpylog
    • pip install pyNastran
For gui support (optional; required for GUI):
  • From Windows binaries: * Download VTK:

    • VTK-7.1.1-cp27-cp27m-win_amd64.whl (Python 2.7)
    • VTK-8.1.2-cp36-cp36m-win_amd64.whl (Python 3.6)
    • VTK-8.1.2-cp37-cp37m-win_amd64.whl (Python 3.7)
  • On the command line:
    • pip install imageio (optional for animation support)
    • pip install VTK*.whl
    • pip install pyqt
    • pip install qtpy

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-master)
  • 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-master 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)

There are two ways to install the 1.2 (master/dev) version of pyNastran

  1. Download the most recent zip version
  2. 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.

installation/clone.png

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.2 --progress -v "https://github.com/SteveDoyle2/pyNastran.git" "C:\\work\\pyNastran_1.2"

Two options for documentation exist.

Build Docs

Navigate to pyNastran/docs_sphinx directory on the command line.

>>> make html