Quick Reference

This page provides quick code snippets for common PyP6Xer operations. For detailed explanations, see the Getting Started Guide.

Installation

pip install PyP6XER

Basic Usage

Import and Load XER File

from xerparser.reader import Reader

# Load XER file
xer = Reader("project.xer")

Access Projects

# Get all projects
for project in xer.projects:
    print(f"Project: {project.proj_short_name}")
    print(f"Activities: {len(project.activities)}")

Access Activities

# Get first project
project = xer.projects[0]

# Iterate through activities
for activity in project.activities:
    print(f"Activity: {activity.task_name}")
    print(f"Duration: {activity.duration} days")
    print(f"Start: {activity.early_start_date}")
    print(f"Finish: {activity.early_end_date}")

Access Resources

# Get all resources
for resource in xer.resources:
    print(f"Resource: {resource.rsrc_name}")
    print(f"Type: {resource.rsrc_type}")

Access Calendars

# Get all calendars
for calendar in xer.calendars:
    print(f"Calendar: {calendar.clndr_name}")
    print(f"Hours per day: {calendar.day_hr_cnt}")

One-Liners

# Count total activities across all projects
total_activities = sum(len(p.activities) for p in xer.projects)

# Get all activity names
activity_names = [act.task_name for p in xer.projects for act in p.activities]

# Find activities by status
active_tasks = [act for p in xer.projects for act in p.activities 
                if act.status_code == "TK_Active"]

# Get all resource assignments
assignments = [ra for ra in xer.taskrsrcs]

# Find critical path activities (zero total float)
critical_activities = [act for p in xer.projects for act in p.activities 
                      if act.total_float_hr_cnt == 0]

Common Patterns

Error Handling

from xerparser.reader import Reader

try:
    xer = Reader("project.xer")
    print(f"Successfully loaded {len(xer.projects)} projects")
except Exception as e:
    print(f"Error loading XER file: {e}")

Data Export

import csv

# Export activities to CSV
with open('activities.csv', 'w', newline='') as csvfile:
    writer = csv.writer(csvfile)
    writer.writerow(['Project', 'Activity', 'Duration', 'Start', 'Finish'])
    
    for project in xer.projects:
        for activity in project.activities:
            writer.writerow([
                project.proj_short_name,
                activity.task_name,
                activity.duration,
                activity.early_start_date,
                activity.early_end_date
            ])

Filtering and Analysis

# Filter activities by date range
from datetime import datetime

start_date = datetime(2024, 1, 1)
end_date = datetime(2024, 12, 31)

filtered_activities = [
    act for p in xer.projects for act in p.activities
    if act.early_start_date and start_date <= act.early_start_date <= end_date
]

DCMA 14-Point Analysis

from xerparser.dcma14.analysis import DCMA14

# Perform DCMA analysis
analysis = DCMA14(xer)
results = analysis.analysis()

# Print summary
print(f"Activities with no predecessors: {results['analysis']['predecessors']['cnt']}")
print(f"Activities with no successors: {results['analysis']['successors']['cnt']}")
print(f"Critical activities: {results['analysis']['critical']['cnt']}")

For more detailed examples and advanced usage, see: