# analysis_engine
Software for portfolio management reporting and analysis in the UK Department for Transport, operated via command line
interface (CLI) prompts.
## Installing
Python must be installed on your computer. If not already installed, it can be installed via the python website
[here](https://www.python.org/downloads/). **IMPORTANT** ensure that `Add Python to PATH` is ticked when provided
with the option as part of the installation wizard.
Open the command line terminal (Windows) or bash shell and install via `pip install analysis_engine`.
## Directories, file paths and poppler.
In order to operate the correct directories and files must be set-up and saved on the user's computer.
`analysis_engine` is able to handle different operating systems.
Create the following directories in your `My Documents` directory:
|-- ipdc
|-- core_data
|-- json
|-- input
|-- output
|-- top250
|-- core_data
|-- json
|-- input
|-- output
Each reporting process e.g. ipdc and top250, respective `core_data` directorates require:
1) excel master data files;
2) excel project information file; and,
3) A confi.ini file. This file lists and master data and project information file names.
As a minimum the `input` folder should have the following documents `summary_temp.docx`,
`summary_temp_landscape.docx`. In addition `ipdc\input` should have the
`dashboards_master.xlsx` file.
All outputs from analysis_engine will be saved into the `output` directory.
The `json` folder is where analysis_engine saves master data in an easily accessible
format (.json) and after setup can be ignored by the user.
Unfortunately there is one further manual installation, related to a package within analysis_engine
which enables high quality rendering of graphical outputs to word documents. On Windows do the following:
1) Download zip of poppler release from this link https://github.com/oschwartz10612/poppler-windows/releases/download/v21.03.0/Release-21.03.0.zip.
2) unzip and move the whole directory to My Documents.
3) Add the poppler bin directory to PATH following these instructions
https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/
4) Reboot computer.
Mac users should follow instructions here https://pypi.org/project/pdf2image/
Most Linux distributions should not require any manual installation.
## Operating analysis_engine
To operate analysis_engine the user must enter the initial **_command_**
`analysis` followed by a _**subcommand**_ to specify the reporting process e.g
`ipdc` or `top250` and then finally an analytical output **_argument_**, the options
for which are set out below.
**NOTE** the `--help` option is available throughout the entire command
line prompt construction process and the user should use it for guidance on what subcommands
and arguments are available for use.
analysis_engine currently has the following _arguments_:
`initiate` The user must enter this command
every time master data, contained in the core_data directory, is updated.
The initiate checks and validates the data in a number of ways.
`dashboards` populates the IPDC PfM report dashboard. A blank template dashboard
must be saved in the ipdc/input directory. (Not currently available for top250.)
`dandelion` produces the portfolio dandelion info-graphic.
`costs` produces a cost profile trend graph and data. (Not currently available for top250.)
`milestones` produces milestone schedule graphs and data.
`vfm` produces vfm data. (Not currently available for top250.)
`summaries` produces project summary reports.
`risks` produces risk data. (Not currently available for top250.)
`dcas` produces dca data. (Not currently available for top250.)
`speedial` prints out changes in project dca ratings. (Not currently available for top250.)
`query` returns (from master data) specific data required by the user.
The default for each argument is to return outputs with current and last quarter data.
Further to each argument the user can specify one or many
further **_optional_arguments_** to alter the analytical output produced. There are
many optional_arguments available, which vary for each argument,
and the user should use the `--help` option to specify those that are available.
Raw data
{
"_id": null,
"home_page": "https://github.com/banillie/analysis_engine",
"name": "analysis-engine",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "",
"author": "Will Grant",
"author_email": "will.granty@yahoo.co.uk",
"download_url": "https://files.pythonhosted.org/packages/4b/6c/bdc569a3f95ac9c4fe0957def4ed322cc8290653376ced840f4a1567bd48/analysis_engine-2.0.14.tar.gz",
"platform": null,
"description": "# analysis_engine \n\nSoftware for portfolio management reporting and analysis in the UK Department for Transport, operated via command line \ninterface (CLI) prompts. \n\n## Installing\nPython must be installed on your computer. If not already installed, it can be installed via the python website\n[here](https://www.python.org/downloads/). **IMPORTANT** ensure that `Add Python to PATH` is ticked when provided \nwith the option as part of the installation wizard. \n\nOpen the command line terminal (Windows) or bash shell and install via `pip install analysis_engine`.\n\n## Directories, file paths and poppler.\nIn order to operate the correct directories and files must be set-up and saved on the user's computer. \n`analysis_engine` is able to handle different operating systems. \n\nCreate the following directories in your `My Documents` directory:\n\n |-- ipdc\n |-- core_data\n |-- json\n |-- input\n |-- output\n |-- top250\n |-- core_data\n |-- json\n |-- input\n |-- output\n\n\nEach reporting process e.g. ipdc and top250, respective `core_data` directorates require:\n1) excel master data files; \n2) excel project information file; and,\n3) A confi.ini file. This file lists and master data and project information file names.\n\nAs a minimum the `input` folder should have the following documents `summary_temp.docx`, \n`summary_temp_landscape.docx`. In addition `ipdc\\input` should have the \n`dashboards_master.xlsx` file. \n\nAll outputs from analysis_engine will be saved into the `output` directory.\n\nThe `json` folder is where analysis_engine saves master data in an easily accessible \nformat (.json) and after setup can be ignored by the user. \n\nUnfortunately there is one further manual installation, related to a package within analysis_engine \nwhich enables high quality rendering of graphical outputs to word documents. On Windows do the following:\n\n1) Download zip of poppler release from this link https://github.com/oschwartz10612/poppler-windows/releases/download/v21.03.0/Release-21.03.0.zip.\n2) unzip and move the whole directory to My Documents.\n3) Add the poppler bin directory to PATH following these instructions\n https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/\n4) Reboot computer.\n\nMac users should follow instructions here https://pypi.org/project/pdf2image/\n\nMost Linux distributions should not require any manual installation. \n\n## Operating analysis_engine\n\nTo operate analysis_engine the user must enter the initial **_command_** \n`analysis` followed by a _**subcommand**_ to specify the reporting process e.g\n`ipdc` or `top250` and then finally an analytical output **_argument_**, the options\nfor which are set out below. \n\n**NOTE** the `--help` option is available throughout the entire command\nline prompt construction process and the user should use it for guidance on what subcommands\nand arguments are available for use. \n\nanalysis_engine currently has the following _arguments_:\n\n`initiate` The user must enter this command\nevery time master data, contained in the core_data directory, is updated.\nThe initiate checks and validates the data in a number of ways. \n\n`dashboards` populates the IPDC PfM report dashboard. A blank template dashboard \nmust be saved in the ipdc/input directory. (Not currently available for top250.)\n\n`dandelion` produces the portfolio dandelion info-graphic. \n\n`costs` produces a cost profile trend graph and data. (Not currently available for top250.)\n\n`milestones` produces milestone schedule graphs and data.\n\n`vfm` produces vfm data. (Not currently available for top250.) \n\n`summaries` produces project summary reports. \n\n`risks` produces risk data. (Not currently available for top250.)\n\n`dcas` produces dca data. (Not currently available for top250.)\n\n`speedial` prints out changes in project dca ratings. (Not currently available for top250.)\n\n`query` returns (from master data) specific data required by the user. \n\nThe default for each argument is to return outputs with current and last quarter data.\n\nFurther to each argument the user can specify one or many \nfurther **_optional_arguments_** to alter the analytical output produced. There are \nmany optional_arguments available, which vary for each argument, \nand the user should use the `--help` option to specify those that are available. \n",
"bugtrack_url": null,
"license": "",
"summary": "Analysis for the UK Department for Transport's major projects portfolio",
"version": "2.0.14",
"project_urls": {
"Homepage": "https://github.com/banillie/analysis_engine"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "79ed13ac92d2ccfc8e95c3b50ec19581ccc364ab58120edf6854d150c1da4bee",
"md5": "9489cd135fac40d5bde3053ffe87cf81",
"sha256": "e7d024f271c13939baad825af6a29d03475c69e7440e9f66ea013230ee86f5b7"
},
"downloads": -1,
"filename": "analysis_engine-2.0.14-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9489cd135fac40d5bde3053ffe87cf81",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 151068,
"upload_time": "2023-08-04T11:31:21",
"upload_time_iso_8601": "2023-08-04T11:31:21.989598Z",
"url": "https://files.pythonhosted.org/packages/79/ed/13ac92d2ccfc8e95c3b50ec19581ccc364ab58120edf6854d150c1da4bee/analysis_engine-2.0.14-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4b6cbdc569a3f95ac9c4fe0957def4ed322cc8290653376ced840f4a1567bd48",
"md5": "8f3457c28558894ab6afecc2bae4fefc",
"sha256": "5eb9fd0ba5e86e4d82a40b9459382c8927f223987e38144274707ac7b9a9a5bb"
},
"downloads": -1,
"filename": "analysis_engine-2.0.14.tar.gz",
"has_sig": false,
"md5_digest": "8f3457c28558894ab6afecc2bae4fefc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 147387,
"upload_time": "2023-08-04T11:31:23",
"upload_time_iso_8601": "2023-08-04T11:31:23.215849Z",
"url": "https://files.pythonhosted.org/packages/4b/6c/bdc569a3f95ac9c4fe0957def4ed322cc8290653376ced840f4a1567bd48/analysis_engine-2.0.14.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-04 11:31:23",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "banillie",
"github_project": "analysis_engine",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "analysis-engine"
}
JSON
