beam3d Files

Installing binaries on Windows
===============================

 File beam3d-0.0.0.msi is windows installer which will install
 files in C:\beam3d. This is intended to be a convenient way of installaton
 if MinGW is not present on computer. Installation includes bash.exe as well.
 The bin folder provides beam3d.bat and m4beam3d.bat which can be copied to
 arbitrary location on the computer and input files can be simple
 drag-and-dropped into icon of these files. The m4beam3d.bat will run
 m4 before invoking beam3d.

 A zip file beam3d-0.0.0.zip is intended to be used if either MinGW
 (http://www.mingw.org/) or only submodule MSYS from MinGW is present.
 Paste zipped folder into mingw root folder. This should result in merging folders
 bin with [mingw_root_folder]/bin, share with [mingw_root_folder]/share etc.
 Then, beam3d can be run through the bash.
 The content of the file is presented below.

 Note: After MinGW/msys installation is complited, and without running
 postinstall, run postinstall if offered.

 See also LaTeX.

mingw
├── bin
│   ├── beam3d.exe
│   ├── libbeam3d.dll
│   └── libtestBeam3d.dll
└── share
    ├── beam3d
    │   ├── awk
    │   │   ├── dome
    │   │   └── grid
    │   ├── doc
    │   │   ├── beam3d.pdf
    │   │   └── Test_beam3d-MINGW32_NT-6.1.pdf
    │   └── test
    │       ├── test_1_x.dat
    │       ├── test_1_x.dat.prt
    │       ├── test_1_xy.dat
    │       ├── test_1_xy.dat.prt
    │       ├── test_1_y.dat
    │       ├── test_1_y.dat.prt
    │       ├── test_2.dat
    │       ├── test_2.dat.prt
    │       ├── test_3.dat
    │       ├── test_3.dat.prt
    │       ├── test_4.dat
    │       ├── test_4.dat.prt
    │       ├── test_5_1.dat
    │       ├── test_5_1.dat.prt
    │       ├── test_5_2.dat
    │       ├── test_5_2.dat.prt
    │       ├── test_6.dat
    │       └── test_6.dat.prt
    ├── doc
    │   └── beam3d
    │       ├── AUTHORS
    │       ├── ChangeLog
    │       ├── COPYING
    │       ├── NEWS
    │       └── README
    └── info
        └── beam3d.info

Installing using make
===============================

 The GNU make http://www.gnu.org/software/make is used. Therefore,
 usual configure and make apply ie.
 * uncompress source into desired folder
 * from bash shell change the current directory to folder above
 * if used on windows, follow fedora2mingw.sh

RPM based Package Manager
===============================

 The beam3d.spec file is provided. After ensuring that rpmbuld is
 available to the system, run: rpmbuild -ta SOURCES/beam3d-0.0.0.tar.gz.
 Once rpm files are created, proceed as usual with rpm packages.

LaTeX – A document preparation system
===============================

 To create pdf files from test runs, LaTeX is necessary. LaTeX itself
 includes a number of packages. The windows version normally, if invoked
 missing package, offers to user to download and install missing packages.
 Follow, for example http://www.miktex.org/ to install
 LaTeX (https://www.latex-project.org/)

 Note: MiKTeX already includes ghostscript (http://www.ghostscript.com/)
 mgs.exe in  MiKTeX bin folder.