PDQ (Pretty Damn Quick)\Software Distribution

PDQ (Pretty Damn Quick)
Software Distribution

What is PDQ and where can I learn to use it?

Current Distribution

Version:       7.0.0
Build:       112420
Languages:       R, C, (Python deferred), Legacy: Perl, Java, and PHP
Platforms:       Linux, macOS, and Windows (Legacy: Solaris)
Maintainers:       Neil Gunther,
Contributors:       Denny Chen, Phil Feller, Peter Harding, Paul Puglia, Sam Zallocco

Contents

1  Version 7.0.0
    1.1  Partitioning
    1.2  LANGUAGE: R Installation
        1.2.1  OPERATING SYSTEM: Linux, macOS, Unix
        1.2.2  OPERATING SYSTEM: Windows
2  Version 6.2.0
    2.1  LANGUAGE: Perl Installation
        2.1.1  OPERATING SYSTEM: Linux, macOS, Unix
        2.1.2  OPERATING SYSTEM: Windows
    2.2  LANGUAGE: Python Installation
        2.2.1  OPERATING SYSTEM: Linux, macOS, Unix
        2.2.2  OPERATING SYSTEM: Windows
    2.3  LANGUAGE: R Installation
        2.3.1  OPERATING SYSTEM: Linux, macOS, Unix
        2.3.2  OPERATING SYSTEM: Windows

1  Version 7.0.0

The previous release was 6.2.0, build 082015 of 2015. That release can still be downloaded from SourceForge. Then follow the instructions in Section 2 for Version 6.2.0.
The key new features in PDQ Version 7 ( download links are below ) are:
  1. The introduction of STREAMING solution method for OPEN queueing networks. (cf. CANON, which can still be used).
  2. The CreateMultiNode() function is now defined for CLOSED queueing networks and distinguished via the MSC device type (cf. MSO for OPEN networks).
  3. The format of Report() has been modified to make the various types of queueing network parameters clearer.
  4. See the R Help pages in RStudio for details.
  5. Run the demo(package="pdq") command in the R console to review a variety of PDQ 7 models.
Maintenance changes:

1.1  Partitioning

To simplify the installation process, the PDQ software distribution has been partitioned by both:
  1. LANGUAGE, viz., Perl, Python and R,
  2. OPERATING SYSTEM, viz., Linux, MacOS, Unix, Windows.
since the PDQ 6.1.1 release.
Please choose your poison from the below subsections, and assiduously follow those particular installation instructions.

1.2  LANGUAGE: R Installation

1.2.1  OPERATING SYSTEM: Linux, macOS, Unix

*** Download this R tarball.
MacOS requires the clang compiler from XCode tools.
Also, make sure you have R installed
  1. Download R for Mac OS X
  2. Download R for Linux
  3. Download R for Windows
Then, follow these steps:
  1. Change directory (cd) into the top-level `pdq' folder
  2. Execute the following commands in a terminal window:
    1. sudo R CMD INSTALL pdq_7.0-0.tar.gz

1.2.2  OPERATING SYSTEM: Windows

Building PDQ-R on Microsoft Windows is fairly simple process, even for those R Windows users who don't regularly build packages from sources.
The steps are these:
  1. Download and install R tools for Windows from CRAN
  2. *** Download this PDQ-R tarball into a local directory, e.g. C:\Users\Example\R-SRC
    Note the underscore in the tarball file name, which should not to be confused with the full PDQ distribution tarball.
  3. Start your version of R
  4. Use the command install.packages from the R console to install the package. The command will be something like this:
    install.packages("source_directory\\pdq_7.0-0.tar.gz",repos=NULL,type="source")
  5. For the source directory shown in the earlier example, the complete command would be:
    install.packages("C:\\Users\\Example\\R-SRC\\pdq_7.0-0.tar.gz",repos=NULL,type="source")

2  Version 6.2.0

This is the current release. PDQ 7.0 is still in development.
To simplify the installation process, the PDQ software distribution has been partitioned by both:
  1. LANGUAGE, viz., Perl, Python and R,
  2. OPERATING SYSTEM, viz., Linux, MacOS, Unix, Windows.
since the PDQ 6.1.1 release.
Please choose your poison from the below subsections, and assiduously follow those particular installation instructions.

2.1  LANGUAGE: Perl Installation

After you complete this stand-alone installation of Perl PDQ, you can separately retrieve the PDQ models that are discussed in the Perl::PDQ book from the examples directory on Github where they are organized according to the respective book chapters in which they appear.

2.1.1  OPERATING SYSTEM: Linux, macOS, Unix

Mac OS requires the clang compiler from XCode tools.
Follow these steps:
  1. Click to download this PERL source tarball
  2. Unpack it
  3. Change directory (cd) into the top-level `pdq' folder
  4. Execute the following commands in a terminal window:
    1. Perl Makefile.PL
    2. make
    3. make test (A PDQ report will be displayed if the execution of test.pl is successful)
    4. make install

2.1.2  OPERATING SYSTEM: Windows

The Perl PDQ module has been successfully built and tested using both Strawberry Perl and ActiveState Perl.
Strawberry Perl ships with all the necessary compilers need for installing. If you're running this is the version of Perl, proceed immediately to step 1 below.
For ActiveState Perl, you need to install 2 additional ActiveState PPMs for the build process to succeed. You can do this via the following commands:
  1. Click to download this PERL source tarball
  2. Unpack it
  3. Open a CMD window as Administrator
  4. Change directory (cd) into the top-level `pdq' folder
  5. Execute the following commands:
    1. Perl Makefile.PL
    2. dmake (Note that it's dmake, NOT make)
    3. dmake test (A PDQ report will be displayed if the execution of test.pl is successful)
    4. dmake install

2.2  LANGUAGE: Python Installation

2.2.1  OPERATING SYSTEM: Linux, macOS, Unix

macOS requires the clang compiler from XCode tools.
The default procedure for building the Python extension is:
  1. Download the Python tarball
  2. Unpack it
  3. Change directory (cd) to the `pdq' folder
  4. python setup.py install will build and install the package on most platforms, if run as root. On MacOS, this can also be accomplished by prepending the sudo command as sudo python setup.py install. If you don't have root access on the install machine, a "local" compile can be included in your PYTHONPATH with the command python setup.py install -user.
You can test whether or not the install is working correctly by running the test.py script located in the `pdq' directory.
After you complete this stand-alone installation of Python PDQ, you will find some example PyDQ models in the Python Models directory on Github.

2.2.2  OPERATING SYSTEM: Windows

Currently, there is no offical support for python under Windows.

2.3  LANGUAGE: R Installation

Click to download this R tarball.

2.3.1  OPERATING SYSTEM: Linux, macOS, Unix

MacOS requires the clang compiler from XCode tools.
Make sure you have R installed
  1. Download R for Mac OS X
  2. Download R for Linux
  3. Download R for Windows
Then, follow these steps:
  1. Change directory (cd) into the top-level `pdq' folder
  2. Execute the following commands in a terminal window:
    1. R CMD INSTALL pdq_6.2-0.tar.gz

2.3.2  OPERATING SYSTEM: Windows

Building PDQ-R on Microsoft Windows is fairly simple process, even for those R Windows users who don't regularly build packages from sources.
The steps are these:
  1. Download and install R tools for Windows from CRAN
  2. Download the PDQ-R tarball into a local directory, e.g. C:\Users\Example\R-SRC
    Note the underscore in the tarball file name, which should not to be confused with the full PDQ distribution tarball.
  3. Start your version of R
  4. Use the command install.packages from the R console to install the package. The command will be something like this:
    install.packages("source_directory\\pdq_6.0-1.tar.gz",repos=NULL,type="source")
  5. For the source directory shown in the earlier example, the complete command would be:
    install.packages("C:\\Users\\Example\\R-SRC\\pdq_6.0-1.tar.gz",repos=NULL,type="source")


File translated from TEX by TTH, version 3.81.
On 28 Mar 2021, 08:21.