Improving Project Documentation and Change Management –

Instrumentation engineers can save time, money and effort by applying standards and tools that centralize and automate the documentation process. This feature originally appeared in the April issue of InTech magazine.
An automated, standards-based documentation process saves time and cost while increasing quality.

The production of design and engineering documents for automation projects is expensive and time consuming, and the output quality can vary considerably, because often the processes are mostly manual. However, many tools are available that can reduce time and cost, while increasing documentation quality. Engineering, procurement, and construction (EPC) contractors, instrumentation engineers, consultants, and others use these tools in projects, and educational institutions use them to train the next generation of users.

The centralization and automation of document production saves time and money and removes many manual, error-prone steps. Combining these tools with international standards makes the output more consistent across end user, EPC, sector, and country. Many instrumentation engineers are accustomed to manual methods for creating the complex engineering and design documents and drawings required for typical process industry projects. These manual methods are inefficient, expensive and subject to human error.

A typical small process industry project with 1,000 input/output (I/O) tags may spend more than six months producing required documentation, incurring costs of around $150,000, assuming no errors. Medium and large projects will see proportional increases in these costs and timescales. Problems identified and corrected later in the project may significantly contribute to project cost overruns.

Changes are common to any automation project, whether to correct errors or to address new functional requirements. Change management is a major challenge to project cost and timescale. Managing changes through manual processes is prone to error and consumes a major portion of project implementation time.
At a minimum, a typical process industry instrumentation project needs the following engineering and design documents:

Figure 1: Instrument index generated from an automated solution

Currently, instrument engineers use several tools to produce project documentation, with Microsoft Excel and AutoCAD being the most widely used. Excel is well-suited to produce information lists, and there are many functions, such as filtering and searching, that can aid users when accessing the information. Excel works well for projects with small I/O counts and can potentially produce many of the list documents described above, such as instrument index, schedules and I/O listings.

Excel has limited drawing capabilities. Tools such as AutoCAD are more suitable for producing loop diagrams, hookup drawings, PFDs, and P&IDs. AutoCAD is a computer-aided design (CAD) tool used across multiple sectors to produce engineering drawings. Table 1 lists the limitations of current tools related to scalability, lack of centralization and required skills.
Table 1: Limitations of current tools
Lack of centralization
Skill requirements
There are limits in many commercial tools. There is a limit of 65,536 rows in older versions of Excel. Newer versions support 220 rows, but at this size, the performance of the application is unacceptable on most desktop computers.
It is often necessary to use multiple tools because one alone cannot produce all the documents required. Using multiple tools can create discrepancies in output from the different tools.
AutoCAD requires substantial user experience to produce the typical project drawings described. Creating the project documents needed in Excel requires user knowledge of macros, Visual Basic, and other Microsoft automation tools.

ISA is a standards development organization (SDO) accredited by the American National Standards Institute (ANSI). ISA produces standards for the automation profession, including standards governing symbols and nomenclature, safety, and communications. ISA has been creating standards for more than 75 years and has produced several publications to ensure automation professionals have the technical resources they need to be successful. Engineering and automation professionals use ISA standards in their day-to-day work designing PFDs, P&IDs (Figure 2), instrument indexes, specification forms/data sheets, logic diagrams, and loop diagrams.

Instrumentation documentation must follow all applicable company, sector, and country standards. The use of ISA standards ensures a consistent approach across company, sector, and country. The ISA website has a complete list of all ISA standards, and ISA members have read-only access to all ISA standards. Some standards that ISA produces relating to instrumentation documentation include:
With standards-driven processes and workflows comes the assurance of following the best industry practices during the definition, design, development, integration, documentation, and support of automation projects. This ensures the execution of projects with precision and standardization. Benefits to a project include:
Considering the limitations of existing methods, an automated solution should:
Figure 3 shows an example of an output from such an automated solution. The data in the diagram comes from a central database, and its placement is automatic. The user specifies certain basic parameters and can also change these parameters and obtain updated documents immediately.

Figure 3: Loop diagram generated from an automated solution

Considering the example cited above of a small project with about 1,000 I/O, below is a comparison of the approximate time taken to produce design and engineering documents by an automated tool instead of methods using Excel, AutoCAD, and other conventional tools. With the automated solution, there is an upfront investment to define the project properties and parameters, specify the tag formats, create user roles and permissions, and create detailed records for all devices in the project.

In a well-designed automated solution, this is a one-time activity. Thereafter, generating any of the required project documents is instantaneous. Because of the centralization of data, there is far less work validating information across documents produced from the same centralized source of information.

In comparison, users applying conventional methods spend significant amounts of time generating and regenerating project documents as changes arise, as well as validating the information across these documents.

A well-designed automation solution can execute a project with 1,000 I/O with 60 percent less effort compared to using conventional methods. This saving grows as the I/O scope increases due to efficiencies in the automated process. Considering the potential to save time and cost while increasing quality, there is a strong case for using a standards-based automated solution to generate documentation in automation projects.

This feature originally appeared in the April issue of InTech magazine.

Vilas Desai is a member of ISA and has recently been invited to join the ISA20 committee that promotes uniformity in instrument specifications. Desai is the inventor of the software tool Plantworx for Instrumentation Engineers and the CEO of SoftBrains, an engineering services company for process automation based in Bangalore, India. 

Steve Mustard, PE, Eur. Ing., CEng, CAP, GICSP, FIET, is an industrial automation consultant with extensive technical and management experience across multiple sectors. A widely recognized expert in industrial cybersecurity and an ISA99 Security Standards committee member, Mustard actively participates in cybersecurity working groups formed by the Automation Federation.
Check out our free e-newsletters to read more great articles..
©2020, a subsidiary of ISA


Leave a Comment