# -*- coding: utf-8 -*-
from reportlab.lib.pagesizes import A4
from reportlab.lib.units import mm
from reportlab.lib import colors
from reportlab.platypus import (SimpleDocTemplate, Paragraph, Spacer, ListFlowable,
                                 ListItem, Table, TableStyle, PageBreak)
from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle
from reportlab.lib.enums import TA_CENTER, TA_JUSTIFY

styles = getSampleStyleSheet()

title_style = ParagraphStyle('TitleX', parent=styles['Title'], fontSize=18, spaceAfter=4, textColor=colors.HexColor('#1a3c6e'))
sub_style = ParagraphStyle('SubX', parent=styles['Normal'], fontSize=11, alignment=TA_CENTER, textColor=colors.HexColor('#555555'), spaceAfter=14)
h1 = ParagraphStyle('H1', parent=styles['Heading1'], fontSize=14, textColor=colors.HexColor('#1a3c6e'), spaceBefore=14, spaceAfter=6)
h2 = ParagraphStyle('H2', parent=styles['Heading2'], fontSize=12, textColor=colors.HexColor('#2e5aa8'), spaceBefore=10, spaceAfter=4)
body = ParagraphStyle('Body', parent=styles['Normal'], fontSize=10.3, leading=15, alignment=TA_JUSTIFY, spaceAfter=6)
bullet = ParagraphStyle('Bullet', parent=body, leftIndent=12, spaceAfter=3)
note = ParagraphStyle('Note', parent=styles['Normal'], fontSize=9, leading=12, textColor=colors.HexColor('#444444'), spaceAfter=6, alignment=TA_JUSTIFY)

def P(text, style=body):
    return Paragraph(text, style)

def bullets(items, style=bullet):
    return ListFlowable([ListItem(P(i, style)) for i in items], bulletType='bullet', leftIndent=14, bulletFontSize=8, spaceBefore=2, spaceAfter=8)

story = []

story.append(P("Hybridisation in Conservative Dentistry and Endodontics", title_style))
story.append(P("Model Long-Answer / 50-Marks Essay  |  Adhesive Dentistry & Dentin Bonding", sub_style))

story.append(P("Marking Scheme Guide (suggested distribution)", h1))
table_data = [
    ["Section", "Marks"],
    ["Introduction, definition, historical background", "5"],
    ["Smear layer and its role", "5"],
    ["Mechanism / process of hybridisation (enamel + dentin)", "10"],
    ["Structure of the hybrid layer", "5"],
    ["Generations of dentin bonding agents & etching strategies", "10"],
    ["Factors affecting hybridisation / bond quality", "5"],
    ["Hybridisation in Endodontics (posts, sealers, resin cements)", "6"],
    ["Problems, degradation (nanoleakage, MMPs) & recent advances", "6"],
    ["Clinical significance, summary/conclusion, diagram, references", "3"],
]
t = Table(table_data, colWidths=[130*mm, 25*mm])
t.setStyle(TableStyle([
    ('BACKGROUND', (0,0), (-1,0), colors.HexColor('#1a3c6e')),
    ('TEXTCOLOR', (0,0), (-1,0), colors.white),
    ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
    ('FONTSIZE', (0,0), (-1,-1), 9.5),
    ('GRID', (0,0), (-1,-1), 0.5, colors.grey),
    ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, colors.HexColor('#eef2f8')]),
    ('ALIGN', (1,0), (1,-1), 'CENTER'),
    ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
    ('TOPPADDING', (0,0), (-1,-1), 4),
    ('BOTTOMPADDING', (0,0), (-1,-1), 4),
]))
story.append(t)
story.append(Spacer(1, 10))

# 1. Introduction
story.append(P("1. Introduction and Definition", h1))
story.append(P(
"Hybridisation is the fundamental biophysical process underlying all contemporary adhesive (tooth-coloured) restorative dentistry. It refers to the formation of a resin-reinforced tooth structure created when a low-viscosity resin monomer infiltrates an acid-etched, demineralised tooth substrate (enamel or dentin) and polymerises in situ, producing a mechanically interlocked composite of resin and mineralised/collagenous tissue.", body))
story.append(P(
"The term and concept were introduced by <b>Nakabayashi, Kojima and Masuhara in 1982</b>, who described the \"resin-dentin interdiffusion zone\" formed when monomers infiltrate acid-conditioned dentin and become co-polymerised with the exposed collagen fibril network. This zone, later named the <b>hybrid layer</b>, is neither pure tooth structure nor pure resin, but a hybrid of the two -- hence the name.", body))
story.append(P(
"<b>Definition:</b> The hybrid layer is a submicron-thick zone of dentin (or enamel) in which the inorganic hydroxyapatite has been partially or completely removed by acid conditioning and replaced by resin monomers that interlock with the residual collagen fibril meshwork (in dentin) or the etched rod/interrod pattern (in enamel), forming a micromechanically retentive, resin-tooth interdiffusion zone.", body))
story.append(P(
"Hybridisation is central to modern <b>direct tooth-coloured restorations</b> (composite resin, compomer, resin-modified glass ionomer bonding) and equally to <b>indirect restorations</b> (ceramic/composite inlays, onlays, veneers, crowns cemented with resin cements) as well as to <b>endodontics</b>, where it underlies bonding of fibre posts, resin sealers, and regenerative/restorative procedures after root canal treatment.", body))

# 2. Smear layer
story.append(P("2. The Smear Layer", h1))
story.append(P(
"Any cutting of dentin with rotary or hand instruments -- whether during cavity preparation, crown preparation, or endodontic instrumentation of the root canal -- produces a <b>smear layer</b>: a 1-5 micron thick layer of burnished debris composed of shattered hydroxyapatite crystals and denatured/fragmented collagen. Debris is also packed into the tubule orifices as <b>smear plugs</b>, reducing dentin permeability by nearly 90%.", body))
story.append(P("Significance of the smear layer for hybridisation:", h2))
story.append(bullets([
"It is only loosely adherent to the underlying sound dentin and has low cohesive/adhesive strength, so bonding directly to it produces a weak bond.",
"It physically blocks resin monomers from reaching intact intertubular and peritubular dentin and from entering dentinal tubules.",
"It must be either <b>removed</b> (total-etch/etch-and-rinse technique using 30-40% phosphoric acid) or <b>modified and incorporated</b> (self-etch technique using mild acidic monomers) before effective hybridisation can occur.",
"Complete removal opens tubules and exposes a 3-8 micron thick, fully demineralised, collagen-rich zone which becomes the substrate for the hybrid layer.",
]))

# 3. Mechanism
story.append(P("3. Mechanism / Process of Hybridisation", h1))
story.append(P("A. Hybridisation of Enamel", h2))
story.append(P(
"Enamel is 96% mineral by weight, arranged as tightly packed hydroxyapatite rods. Etching with 30-37% phosphoric acid for 15-30 seconds selectively dissolves either the rod cores or the interrod (peripheral) enamel, creating a honeycomb micro-porous surface with a characteristic frosty white appearance. A low-viscosity unfilled resin (bonding agent) flows into these micro-porosities by capillary action and polymerises, forming <b>resin tags</b> a few microns long. Because enamel hybridisation is purely micromechanical and occurs in a mineral-rich, collagen-poor substrate, enamel bonds are strong, reliable and durable -- the most predictable bond in dentistry.", body))
story.append(P("B. Hybridisation of Dentin (the true \"Hybrid Layer\")", h2))
story.append(P("Dentin bonding is more technique-sensitive because dentin is only 45-50% mineral by volume, is intrinsically wet (tubular fluid under pulpal pressure), and is rich in type I collagen. The sequence of events is:", body))
story.append(bullets([
"<b>Step 1 - Conditioning/Etching:</b> An acid (phosphoric acid in etch-and-rinse, or an acidic self-etch monomer such as 10-MDP/methacrylate phosphates) dissolves the smear layer and demineralises the surface and subsurface dentin to a depth of 3-8 microns, dissolving the hydroxyapatite crystals from around and within the collagen fibrils.",
"<b>Step 2 - Exposure of collagen meshwork:</b> A porous, spongy network of unsupported type I collagen fibrils (previously mineral-encrusted) is left standing, along with widened, funnel-shaped tubule orifices.",
"<b>Step 3 - Priming:</b> A hydrophilic primer/monomer (e.g. HEMA, or self-etch adhesive) diffuses into this wet, collapsible collagen network, keeping it expanded and rendering the hydrophilic dentin receptive to hydrophobic resin.",
"<b>Step 4 - Resin infiltration:</b> Adhesive resin monomers (Bis-GMA, UDMA, TEGDMA blends) diffuse into the same porosities previously occupied by mineral and by the primer, wetting and surrounding each collagen fibril from the surface down to the base of demineralisation.",
"<b>Step 5 - Polymerisation:</b> Light- or chemical-curing polymerises the resin in place, mechanically locking it around and within the collagen fibrils and extending as <b>resin tags</b> into the patent dentinal tubules (where they may also form lateral micro-tag branches from the tubule wall). This resin-collagen-residual mineral composite is the <b>hybrid layer</b> proper, and the resin projections into tubules constitute the <b>resin tags</b>.",
]))
story.append(P(
"The hybrid layer thus provides a graded, micromechanically interlocked transition zone between the bulk restorative resin above and unaltered mineralised dentin below, converting an otherwise abrupt, stress-concentrating interface into a resilient, stress-distributing union.", body))

story.append(PageBreak())

# 4. Structure
story.append(P("4. Structure of the Hybrid Layer", h1))
story.append(bullets([
"<b>Thickness:</b> typically 1-10 microns depending on adhesive system, dentin location and etching time (self-etch systems produce thinner hybrid layers, 0.5-1 micron, than etch-and-rinse systems, 3-8 microns).",
"<b>Composition (top to bottom):</b> (i) adhesive resin layer, (ii) hybrid layer proper -- resin interspersed among exposed collagen fibrils with residual apatite crystals at its base, (iii) resin tags within dentinal tubules, sometimes with lateral branches, (iv) unaffected mineralised dentin.",
"<b>Ultrastructure:</b> demonstrable by SEM/TEM after removal of the mineral phase or the organic phase respectively; the collagen fibrils appear as a fine fibrillar meshwork completely encased in resin when bonding is optimal.",
]))
story.append(P("A good visual analogy used in teaching: the hybrid layer resembles reinforced concrete, where the collagen fibrils act as the reinforcing rods (rebar) and the infiltrated resin acts as the surrounding cement/concrete matrix.", note))

# 5. Generations
story.append(P("5. Generations of Dentin Bonding Agents and Etching Strategies", h1))
story.append(P("Bonding systems are classified historically into generations (I-VIII) and, more practically, by etching strategy:", body))
gen_table = [
    ["Approach", "Steps", "Key Feature", "Example generation"],
    ["Etch-and-rinse\n(Total-etch)", "3-step: etch -> rinse -> prime -> bond\n2-step: etch -> rinse -> prime+bond combined", "Phosphoric acid etches enamel + dentin completely; smear layer removed; deepest, most predictable hybrid layer", "4th gen (3-step),\n5th gen (2-step)"],
    ["Self-etch", "2-step: acidic primer -> separate bond\n1-step (all-in-one): acid+primer+resin combined", "Acidic monomers (10-MDP) simultaneously etch and prime; smear layer modified & incorporated, not removed; thinner hybrid layer, less post-op sensitivity", "6th gen (2-step self-etch),\n7th gen (1-step self-etch)"],
    ["Universal /\nMulti-mode", "1 bottle, usable in etch-and-rinse, self-etch, or selective-enamel-etch mode", "Contains MDP + silane + HEMA; chemical bonding to hydroxyapatite via MDP-calcium salts in addition to micromechanical hybridisation", "8th generation"],
]
gt = Table(gen_table, colWidths=[28*mm, 40*mm, 62*mm, 25*mm])
gt.setStyle(TableStyle([
    ('BACKGROUND', (0,0), (-1,0), colors.HexColor('#1a3c6e')),
    ('TEXTCOLOR', (0,0), (-1,0), colors.white),
    ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
    ('FONTSIZE', (0,0), (-1,-1), 8.3),
    ('GRID', (0,0), (-1,-1), 0.5, colors.grey),
    ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, colors.HexColor('#eef2f8')]),
    ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
    ('TOPPADDING', (0,0), (-1,-1), 4),
    ('BOTTOMPADDING', (0,0), (-1,-1), 4),
]))
story.append(gt)
story.append(Spacer(1,8))
story.append(P(
"<b>Etch-and-rinse (total-etch)</b> gives the deepest, most complete demineralisation and the most extensive hybrid layer but is technique-sensitive: over-drying causes collagen collapse (poor resin penetration), while over-wetting causes water entrapment and hydrolytic degradation. This gave rise to the <b>\"wet-bonding\"</b> concept, where dentin is kept visibly moist (\"glistening\") after rinsing so that HEMA/primer can re-expand the collagen meshwork.", body))
story.append(P(
"<b>Self-etch systems</b> avoid a separate rinsing step, so smear plugs are only partially dissolved and incorporated into the hybrid layer, producing a thinner but more homogeneous hybrid layer, generally lower postoperative sensitivity, but somewhat weaker enamel bonds unless the enamel is selectively etched with phosphoric acid first (\"selective-etch\" technique, now widely recommended as the clinical gold standard with universal adhesives).", body))

# 6. Factors
story.append(P("6. Factors Affecting Hybridisation / Bond Quality", h1))
story.append(bullets([
"<b>Substrate factors:</b> superficial vs deep dentin (tubule density and diameter increase, intertubular dentin decreases towards the pulp -- deep dentin bonds are weaker); sclerotic/caries-affected dentin (fewer tubules, hypermineralised, poor bonding); presence of a smear layer.",
"<b>Moisture control:</b> dentin must be moist but not pooled with water (\"wet bonding\"); over-drying collapses collagen; over-wetting dilutes primer and traps water.",
"<b>Etching time and acid concentration:</b> excessive etching over-demineralises deep dentin beyond the depth of resin infiltration, leaving an unprotected, unhybridised collagen zone prone to hydrolysis (a cause of nanoleakage).",
"<b>Solvent type and evaporation:</b> acetone-, ethanol-, or water-based solvents affect penetration and the necessity of a wet vs dry surface.",
"<b>Application technique:</b> adequate agitation/rubbing time, adequate number of coats, complete solvent evaporation before curing, and adequate light-curing (intensity and time) for full polymerisation.",
"<b>C-factor and polymerisation shrinkage stress</b> of the overlying composite, which can disrupt the still-forming hybrid layer/bond interface.",
"<b>Presence of matrix metalloproteinases (MMPs) and cysteine cathepsins</b> within dentin, activated by acid-etching, which slowly degrade exposed, unprotected collagen fibrils within the hybrid layer over time.",
]))

story.append(PageBreak())

# 7. Endodontics
story.append(P("7. Hybridisation in Endodontics", h1))
story.append(P(
"The principle of resin-tooth hybridisation extends directly into endodontic practice, wherever resin-based materials must bond to radicular dentin:", body))
story.append(P("a) Bonding of fibre posts and core build-ups", h2))
story.append(bullets([
"After post-space preparation, radicular dentin also develops a smear layer and has fewer, more sclerotic tubules than coronal dentin, making hybridisation less predictable.",
"Self-etch or total-etch dual-cure resin cements are used to lute glass-fibre/quartz-fibre posts, forming a hybrid layer along the canal wall analogous to coronal dentin bonding, supplemented by resin tags into radicular tubules.",
"Difficulties: limited visibility/access, incomplete resin cement polymerisation in the apical third (light-cure attenuation), residual eugenol from obturation (if zinc-oxide eugenol sealers were used) inhibiting resin polymerisation, and canal moisture/haemorrhage control.",
]))
story.append(P("b) Resin-based root canal sealers", h2))
story.append(bullets([
"Epoxy-resin-based (e.g. AH Plus) and methacrylate-resin-based sealers can hybridise with radicular dentin and, in some systems, also chemically bond to gutta-percha/resin-coated points, improving the apical and coronal seal against microleakage and bacterial reinfection.",
])
)
story.append(P("c) Post-endodontic restoration and pulp-capping/regenerative procedures", h2))
story.append(bullets([
"Adhesive hybridisation allows conservative, bonded direct composite restorations of endodontic access cavities instead of full-coverage crowns, preserving tooth structure (a core tenet of minimally invasive endodontics).",
"In vital pulp therapy (direct/indirect pulp capping, pulpotomy), bonding agents are sometimes used over calcium hydroxide/MTA/bioceramic bases to seal dentin and support the bonded restoration, although hybridisation directly onto pulpal tissue is avoided due to cytotoxicity concerns with certain monomers.",
]))
story.append(P("d) Clinical relevance", h2))
story.append(P(
"Reliable hybridisation in endodontically treated teeth is critical because these teeth are typically more brittle (loss of coronal structure, decreased moisture, prior access cavity), and a well-formed hybrid layer allows adhesive restorations/posts to reinforce remaining tooth structure and create a coronal seal that prevents bacterial microleakage and reinfection of the root canal system.", body))

# 8. Problems
story.append(P("8. Limitations, Degradation and Recent Advances", h1))
story.append(P("Problems with the hybrid layer:", h2))
story.append(bullets([
"<b>Nanoleakage:</b> microscopic, fluid-filled voids within an incompletely resin-infiltrated hybrid layer (especially at its base) permit ingress of oral fluids/bacterial by-products even without a visible marginal gap, acting as a pathway for degradation and secondary caries.",
"<b>Hydrolytic and enzymatic degradation:</b> water sorption hydrolyses ester bonds in the resin, and endogenous dentin MMPs/cathepsins degrade exposed, unprotected collagen fibrils, weakening the hybrid layer over years (\"hybrid layer degradation\" -- a major cause of long-term bond strength decline and restoration failure).",
"<b>Incomplete resin infiltration</b> relative to the depth of demineralisation, especially with etch-and-rinse systems, leaving unprotected, unhybridised collagen at the base of the hybrid layer.",
"<b>Polymerisation shrinkage stress</b> at the newly formed interface before it has matured, and technique sensitivity of the wet-bonding step.",
]))
story.append(P("Strategies / recent advances to improve durability:", h2))
story.append(bullets([
"<b>Cross-linking agents / collagen stabilisers</b> such as chlorhexidine (broad-spectrum MMP inhibitor), proanthocyanidins, glutaraldehyde and riboflavin/UV cross-linking to strengthen and protect the collagen matrix.",
"<b>Ethanol wet-bonding and biomimetic remineralisation</b> strategies that use non-collagenous protein analogues (e.g. polyvinylphosphonic acid) to guide intrafibrillar remineralisation of the hybrid layer, restoring some of the lost mineral phase.",
"<b>Universal/multi-mode adhesives with 10-MDP</b> that chemically bond to residual hydroxyapatite (forming stable MDP-calcium salts) in addition to micromechanical hybridisation, reducing dependence on a purely collagen-based bond.",
"<b>Self-etch, selective-enamel-etch protocols</b> that minimise excessive dentin demineralisation depth, keeping it within the resin's infiltration capacity.",
"Ongoing research (e.g. the 2024-2025 \"hybrid layer paradox\" literature) argues that incremental refinement of solvents/monomers has plateaued, and that the next generation of adhesives may need to move away from a purely resin-collagen interdiffusion model towards bioactive, self-repairing or fully mineral-integrated interfaces.",
]))

# 9. Summary
story.append(P("9. Clinical Significance and Conclusion", h1))
story.append(bullets([
"Hybridisation is the biological/mechanical basis that allows both <b>direct</b> tooth-coloured restorations (composite, compomer) and <b>indirect</b> restorations (ceramic/composite inlays, onlays, veneers, crowns) to be bonded rather than mechanically retained, enabling minimally invasive, conservative cavity/preparation designs.",
"It underlies resin cementation of all indirect restorations and fibre posts, and contributes to the coronal seal essential for long-term success of endodontically treated teeth.",
"A well-formed, intact hybrid layer improves marginal seal, reduces microleakage/postoperative sensitivity and secondary caries, and improves the longevity of both direct and indirect restorations.",
"Its main clinical weakness is time-dependent degradation, making bonding technique (moisture control, etching strategy, adhesive selection, complete polymerisation) as important as material selection for long-term restoration success.",
])
)
story.append(P(
"<b>In summary:</b> Hybridisation converts the abrupt, biologically distinct interface between resin and tooth structure into a graded, micromechanically and (with modern MDP-based universal adhesives) chemically interlocked transition zone -- the hybrid layer -- that is indispensable to modern conservative dentistry and endodontics, from simple composite fillings to fibre-post retained crowns on root-treated teeth.", body))

story.append(P("Key References", h1))
story.append(bullets([
"Nakabayashi N, Kojima K, Masuhara E. The promotion of adhesion by the infiltration of monomers into tooth substrates. J Biomed Mater Res. 1982;16:265-73.",
"Van Meerbeek B, Yoshihara K, Yoshida Y, et al. State of the art of self-etch adhesives. Dent Mater. 2011;27:17-28.",
"Mazzoni A, Tjaderhane L, Checchi V, et al. Role of dentin MMPs in caries progression and bond stability. J Dent Res. 2015;94:241-51.",
"The hybrid layer paradox: Rethinking the foundations of adhesive dentistry. PMC12721412 (2025).",
"Sturdevant's Art and Science of Operative Dentistry; Fundamentals of Operative Dentistry (Summitt et al.) - chapters on dentin bonding/adhesion.",
"Cohen's Pathways of the Pulp - chapters on restoration of the endodontically treated tooth and fibre post bonding.",
], style=note))

story.append(Spacer(1, 10))
story.append(P("Note: This document is an exam-style model answer synthesised for study purposes. Cross-check against your specific university's syllabus/marking scheme.", note))

doc = SimpleDocTemplate("/tmp/workspace/hybridization-cde/output/Hybridisation_in_Conservative_Dentistry_and_Endodontics.pdf",
                         pagesize=A4, topMargin=18*mm, bottomMargin=16*mm, leftMargin=16*mm, rightMargin=16*mm,
                         title="Hybridisation in Conservative Dentistry and Endodontics")
doc.build(story)
print("PDF built successfully")

# -*- coding: utf-8 -*-
from reportlab.lib.pagesizes import A4
from reportlab.lib.units import mm
from reportlab.lib import colors
from reportlab.platypus import (SimpleDocTemplate, Paragraph, Spacer, ListFlowable,
                                 ListItem, Table, TableStyle, PageBreak)
from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle
from reportlab.lib.enums import TA_CENTER, TA_JUSTIFY

styles = getSampleStyleSheet()

title_style = ParagraphStyle('TitleX', parent=styles['Title'], fontSize=18, spaceAfter=4, textColor=colors.HexColor('#1a3c6e'))
sub_style = ParagraphStyle('SubX', parent=styles['Normal'], fontSize=11, alignment=TA_CENTER, textColor=colors.HexColor('#555555'), spaceAfter=14)
h1 = ParagraphStyle('H1', parent=styles['Heading1'], fontSize=14, textColor=colors.HexColor('#1a3c6e'), spaceBefore=14, spaceAfter=6)
h2 = ParagraphStyle('H2', parent=styles['Heading2'], fontSize=12, textColor=colors.HexColor('#2e5aa8'), spaceBefore=10, spaceAfter=4)
body = ParagraphStyle('Body', parent=styles['Normal'], fontSize=10.3, leading=15, alignment=TA_JUSTIFY, spaceAfter=6)
bullet = ParagraphStyle('Bullet', parent=body, leftIndent=12, spaceAfter=3)
note = ParagraphStyle('Note', parent=styles['Normal'], fontSize=9, leading=12, textColor=colors.HexColor('#444444'), spaceAfter=6, alignment=TA_JUSTIFY)

def P(text, style=body):
    return Paragraph(text, style)

def bullets(items, style=bullet):
    return ListFlowable([ListItem(P(i, style)) for i in items], bulletType='bullet', leftIndent=14, bulletFontSize=8, spaceBefore=2, spaceAfter=8)

story = []

story.append(P("Photon-Induced Photoacoustic Streaming (PIPS)", title_style))
story.append(P("Model Long-Answer / 50-Marks Essay  |  Laser-Activated Irrigation in Endodontics", sub_style))

story.append(P("Marking Scheme Guide (suggested distribution)", h1))
table_data = [
    ["Section", "Marks"],
    ["Introduction, definition, background & development", "5"],
    ["Rationale: limitations of conventional irrigation", "5"],
    ["Laser physics & equipment (Er:YAG, tip design, parameters)", "8"],
    ["Mechanism of action (photoacoustic/photomechanical effect)", "10"],
    ["Clinical technique / protocol", "6"],
    ["Biological effects: smear layer, debris, biofilm, antibacterial", "6"],
    ["Advantages", "4"],
    ["Disadvantages / limitations", "4"],
    ["Comparison with PUI, SWEEPS, sonic & needle irrigation", "5"],
    ["Recent evidence, clinical significance & conclusion", "3"],
]
t = Table(table_data, colWidths=[135*mm, 25*mm])
t.setStyle(TableStyle([
    ('BACKGROUND', (0,0), (-1,0), colors.HexColor('#1a3c6e')),
    ('TEXTCOLOR', (0,0), (-1,0), colors.white),
    ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
    ('FONTSIZE', (0,0), (-1,-1), 9.5),
    ('GRID', (0,0), (-1,-1), 0.5, colors.grey),
    ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, colors.HexColor('#eef2f8')]),
    ('ALIGN', (1,0), (1,-1), 'CENTER'),
    ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
    ('TOPPADDING', (0,0), (-1,-1), 4),
    ('BOTTOMPADDING', (0,0), (-1,-1), 4),
]))
story.append(t)
story.append(Spacer(1, 10))

# 1. Introduction
story.append(P("1. Introduction and Definition", h1))
story.append(P(
"Thorough three-dimensional cleaning and disinfection of the root canal system is one of the central biological objectives of endodontic treatment, yet conventional needle irrigation is often unable to reach into fins, isthmuses, lateral canals, and the apical third because irrigant exchange there is largely limited by penetration depth of the needle and surface tension effects. To overcome this, several irrigant-agitation/activation methods have been developed, one of the most advanced being <b>Photon-Induced Photoacoustic Streaming (PIPS)</b>.", body))
story.append(P(
"<b>Definition:</b> PIPS is a laser-activated irrigation (LAI) technique that uses an <b>Erbium:Yttrium-Aluminium-Garnet (Er:YAG) laser</b> operating at extremely low, sub-ablative energy levels (typically 20 mJ, 15 Hz) delivered through a specially designed, radial/tapered, stripped (non-initiated) 300-400 micron quartz fibre tip placed only in the pulp chamber/coronal reservoir of irrigant (not advanced into the canal). The laser energy is strongly absorbed by water/irrigant, generating rapidly expanding and imploding vapour bubbles that create a photoacoustic shockwave and a three-dimensional streaming/agitation of the irrigant throughout the canal system, without requiring the fibre tip to enter the canal itself.", body))
story.append(P(
"PIPS was developed and popularised by <b>Dr. Enrico DiVito</b>, with contributions from Dr. David Jaramillo and Dr. Mark Colonna, building on earlier work with Er:YAG laser-activated irrigation (LAI) reported by researchers such as De Moor et al. (2010). It represents a refinement of erbium laser-activated irrigation that specifically minimises thermal/ablative tissue effects while maximising the photomechanical/photoacoustic cleaning effect.", body))

# 2. Rationale
story.append(P("2. Rationale -- Limitations of Conventional Irrigation", h1))
story.append(bullets([
"Standard syringe/needle irrigation (SNI) with sodium hypochlorite delivers effective irrigant exchange only 1-1.5 mm beyond the needle tip, so the apical third and any complex anatomy (isthmuses, fins, accessory canals, C-shaped canals) remain poorly disinfected.",
"Vapour lock effect: air/gas trapped at the apex prevents irrigant from reaching the true canal terminus, especially in canals prepared with minimally invasive (conservative taper) preparations.",
"Smear layer and biofilm at the root canal wall and dentinal tubules resist penetration of chemical irrigants alone.",
"These limitations drove the development of agitation/activation devices: manual dynamic agitation, sonic activation, passive ultrasonic irrigation (PUI), negative apical pressure systems (EndoVac), and laser-activated irrigation (LAI), of which PIPS and its successor SWEEPS (Shock Wave Enhanced Emission Photoacoustic Streaming) represent the most recent laser-based approaches.",
]))

# 3. Laser physics
story.append(P("3. Laser Physics and Equipment", h1))
story.append(P("Key technical parameters of PIPS:", h2))
story.append(bullets([
"<b>Laser type:</b> Erbium:Yttrium-Aluminium-Garnet (Er:YAG), wavelength <b>2940 nm</b> -- the wavelength most strongly absorbed by water (hydroxyl absorption peak) and by hydroxyapatite.",
"<b>Energy setting:</b> very low, sub-ablative energy, typically <b>20 mJ per pulse</b> (compared with 150-250 mJ used for hard-tissue ablation/cavity preparation).",
"<b>Pulse repetition rate:</b> approximately <b>15 Hz</b>.",
"<b>Pulse duration:</b> PIPS uses an ultra-short pulse duration (about 50 microseconds, versus ~300 microseconds/longer pulses in conventional Er:YAG use), which generates a much higher peak power for the same total energy -- this short pulse is the key innovation that produces a stronger photoacoustic shockwave without ablating tissue.",
"<b>Delivery tip:</b> a small-diameter (300-400 micron), tapered, stripped (uninitiated/undoped) quartz-silica fibre tip with a flat, radial or conical emission pattern, positioned only in the pulp chamber/canal orifice, never advanced apically into the canal -- unlike PUI files or earlier LAI tips.",
"<b>Irrigant:</b> typically sodium hypochlorite (NaOCl) and/or EDTA is used as the activating fluid; the laser energy is absorbed by both water and the irrigant.",
]))
story.append(P("This combination of very low energy, very short pulse duration and non-contact tip placement distinguishes PIPS from earlier, higher-energy Er:YAG laser-activated irrigation protocols, which risked greater thermal rise and required the tip to be introduced into the canal.", note))

story.append(PageBreak())

# 4. Mechanism
story.append(P("4. Mechanism of Action: The Photoacoustic/Photomechanical Effect", h1))
story.append(P(
"PIPS works by a purely <b>photomechanical/photoacoustic mechanism</b> rather than a photothermal (ablative) one. The sequence of events is:", body))
story.append(bullets([
"<b>Step 1 - Absorption:</b> The 2940 nm Er:YAG wavelength is intensely absorbed within a few microns of the irrigant surface (water/NaOCl) in the pulp chamber.",
"<b>Step 2 - Vapour bubble formation:</b> Each ultra-short, low-energy laser pulse instantaneously superheats a thin film of irrigant, forming an expanding vapour bubble at the fibre tip.",
"<b>Step 3 - Bubble expansion and implosion (cavitation):</b> The bubble expands rapidly and then collapses (implodes) as it cools and pressure equalises, generating a strong <b>shockwave</b> and secondary cavitation bubbles.",
"<b>Step 4 - Photoacoustic streaming:</b> Because pulses are delivered at 15 Hz, this rapid cycle of bubble expansion/implosion is repeated continuously, generating a sustained, three-dimensional <b>fluid streaming/turbulence</b> that propagates the shockwave energy throughout the entire root canal system, including into fins, isthmuses, lateral canals and the apical third, even though the fibre tip itself never leaves the pulp chamber.",
"<b>Step 5 - Cleaning effect:</b> The resulting shear stress, cavitation and secondary streaming disrupt and dislodge the smear layer, dentinal debris, tissue remnants and biofilm from canal walls, and also potentiate the antibacterial action of the irrigant by improving its penetration into dentinal tubules and complex anatomy.",
]))
story.append(P(
"Because the energy is sub-ablative and the pulse is so short, very little heat is generated or transferred to the root surface/periodontal tissues (studies have generally shown minimal temperature rise at the external root surface during correctly parameterised PIPS use), which is the key safety advantage over higher-energy laser protocols.", body))
story.append(P(
"<b>SWEEPS (Shock Wave Enhanced Emission Photoacoustic Streaming)</b>, a further evolution, fires a second laser pulse into the still-expanding vapour bubble created by the first pulse, producing an even stronger secondary shockwave and streaming effect; several comparative studies suggest SWEEPS may equal or exceed PIPS in some cleaning outcomes, though results are mixed across studies.", body))

# 5. Technique
story.append(P("5. Clinical Technique / Protocol", h1))
story.append(bullets([
"Complete conventional canal shaping/instrumentation is carried out first, since PIPS is an <b>adjunct to</b>, not a replacement for, mechanical instrumentation.",
"The canal and pulp chamber are flooded with irrigant (typically NaOCl, sometimes alternated with EDTA/saline for smear layer removal and final rinse).",
"The stripped, tapered fibre tip is placed passively just at or above the canal orifice/pulp chamber, without apical advancement or contact with canal walls.",
"The laser is activated for short intervals, commonly cycles of about <b>20 seconds of activation</b>, repeated 3 times per canal (approximately 3 x 20 second cycles), with fresh irrigant replenished between cycles.",
"Total treatment time per canal is short (around 1-2 minutes), and the protocol can be repeated with different irrigants (e.g. NaOCl cycles followed by EDTA/saline cycles) as part of a final irrigation regimen before obturation.",
"Appropriate laser safety protocols (eye protection, high-volume suction) are required as with any dental laser use.",
]))

# 6. Biological effects
story.append(P("6. Biological Effects", h1))
story.append(P("a) Smear layer and debris removal", h2))
story.append(P(
"Multiple in-vitro (SEM-based) studies (e.g. DiVito et al. 2010, De Moor et al. 2010, Arslan et al. 2014) have demonstrated that PIPS/LAI produces significantly cleaner canal walls and better removal of dentinal debris and smear layer compared with conventional syringe irrigation, including in the apical third and in curved canals, and is comparable to or better than passive ultrasonic irrigation (PUI) in several studies.", body))
story.append(P("b) Antibacterial / antibiofilm effect", h2))
story.append(P(
"Olivi et al. (2014) showed Er:YAG PIPS activation was effective in eradicating <i>Enterococcus faecalis</i> and inhibiting subsequent bacterial regrowth. Other studies confirm PIPS enhances elimination of mixed oral biofilms compared with standard needle irrigation (SNI) alone, attributed to improved irrigant penetration into tubules and better disruption of the biofilm matrix by the photoacoustic shockwave.", body))
story.append(P("c) Removal of intracanal medicaments", h2))
story.append(P(
"Laky et al. (2018) reported that PIPS can effectively and safely assist in removing calcium hydroxide dressing residue from canal walls prior to obturation.", body))
story.append(P("d) Effect on periapical healing / clinical outcomes", h2))
story.append(P(
"Some prospective clinical comparisons suggest laser-activated irrigation protocols (PIPS/SWEEPS) may improve 1-year periapical healing rates compared with conventional syringe irrigation, and produce cleaning efficiency broadly comparable to PUI and manual dynamic agitation, although the evidence base is still evolving and results across studies are not fully consistent.", body))

story.append(PageBreak())

# 7. Advantages
story.append(P("7. Advantages of PIPS", h1))
story.append(bullets([
"Non-contact, minimally invasive: the fibre tip stays in the pulp chamber and is never introduced into the canal, reducing the risk of apical extrusion of irrigant/debris and reducing the ledging/transportation risks associated with instruments advanced to the apex.",
"Enhanced three-dimensional cleaning, reaching into fins, isthmuses, and lateral canals that conventional needle irrigation and even some ultrasonic files cannot access.",
"Sub-ablative energy minimises removal of sound dentin and reduces thermal risk to periodontal/periradicular tissues when used with correct parameters.",
"Potentiates the antibacterial efficacy of existing irrigants (NaOCl/EDTA) rather than requiring new chemical agents.",
"Shorter overall irrigation activation time compared with some ultrasonic protocols.",
"Effective adjunct for removing intracanal medicaments (e.g. calcium hydroxide) before obturation.",
]))

# 8. Disadvantages
story.append(P("8. Disadvantages / Limitations", h1))
story.append(bullets([
"High equipment cost (dedicated Er:YAG laser unit and specific fibre tips), which limits widespread adoption compared with inexpensive ultrasonic/sonic devices.",
"Technique sensitivity: correct energy, pulse duration, frequency and tip positioning are critical; deviation can either reduce efficacy or increase the risk of thermal damage/tissue emphysema.",
"Fragile, single/limited-use fibre tips add to recurring cost, and tip degradation can alter the emission pattern.",
"Evidence base, while growing, is still composed largely of in-vitro/ex-vivo laboratory studies and short-term clinical comparisons; robust long-term randomised clinical outcome data (e.g. healing rates, retreatment rates) remain relatively limited.",
"Some studies show no statistically significant difference between PIPS and PUI/SWEEPS for certain outcomes (e.g. smear layer removal in curved canals), so its superiority is not uniformly established across all parameters.",
"Additional training/learning curve required, and laser safety regulations/protective equipment are mandatory.",
"Does not replace the need for adequate mechanical shaping; it is an adjunctive final irrigation step, not a substitute for canal preparation.",
]))

# 9. Comparison
story.append(P("9. Comparison with Other Irrigant Activation Techniques", h1))
comp_table = [
    ["Technique", "Principle", "Tip in canal?", "Key notes"],
    ["Conventional syringe\nirrigation (SNI)", "Bulk flow/flushing via needle", "Yes (coronal-mid canal)", "Effective range only ~1 mm beyond needle tip; poor apical/lateral cleaning"],
    ["Passive Ultrasonic\nIrrigation (PUI)", "Ultrasonically oscillating smooth file creates acoustic streaming &amp; cavitation", "Yes, but passive (non-cutting)", "Well-established, effective, moderate cost"],
    ["Sonic activation\n(e.g. EndoActivator)", "Sonic (low frequency) oscillation of a polymer tip", "Yes", "Less powerful cavitation than ultrasonic/laser methods"],
    ["PIPS", "Er:YAG sub-ablative photoacoustic shockwave &amp; streaming", "No -- tip stays in chamber", "Strong 3-D streaming without apical tip placement; higher cost"],
    ["SWEEPS", "Dual-pulse Er:YAG, secondary shockwave into existing vapour bubble", "No", "Evolution of PIPS; comparable or superior cleaning in some studies"],
]
ct = Table(comp_table, colWidths=[30*mm, 55*mm, 30*mm, 45*mm])
ct.setStyle(TableStyle([
    ('BACKGROUND', (0,0), (-1,0), colors.HexColor('#1a3c6e')),
    ('TEXTCOLOR', (0,0), (-1,0), colors.white),
    ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
    ('FONTSIZE', (0,0), (-1,-1), 8.3),
    ('GRID', (0,0), (-1,-1), 0.5, colors.grey),
    ('ROWBACKGROUNDS', (0,1), (-1,-1), [colors.white, colors.HexColor('#eef2f8')]),
    ('VALIGN', (0,0), (-1,-1), 'MIDDLE'),
    ('TOPPADDING', (0,0), (-1,-1), 4),
    ('BOTTOMPADDING', (0,0), (-1,-1), 4),
]))
story.append(ct)
story.append(Spacer(1, 8))
story.append(P(
"Comparative laboratory and clinical studies generally place PIPS and SWEEPS at or above the level of PUI for smear layer/debris removal and antibacterial efficacy, though findings vary by canal anatomy, curvature, and outcome measured; several head-to-head studies report <b>no statistically significant difference</b> between PIPS and SWEEPS themselves.", body))

# 10. Conclusion
story.append(P("10. Clinical Significance and Conclusion", h1))
story.append(bullets([
"PIPS represents a technological advance in laser-activated irrigation that improves three-dimensional cleaning and disinfection of the root canal system without requiring apical instrumentation of the fibre tip, potentially reducing procedural risk while enhancing debridement of complex canal anatomy.",
"It is best regarded as a valuable <b>adjunct</b> to, not a replacement for, conventional biomechanical preparation and chemical irrigation with sodium hypochlorite/EDTA.",
"Current evidence supports its efficacy for smear layer removal, debris removal, biofilm/bacterial reduction, and intracanal medicament removal, but cost, technique sensitivity, and the need for further high-quality long-term clinical trials remain limiting factors for universal adoption.",
"As with other new endodontic technologies, clinicians should weigh the added cost and training requirements of PIPS/SWEEPS against the incremental cleaning benefit demonstrated in current literature, particularly in cases with complex canal anatomy where conventional irrigation is known to underperform.",
])
)

story.append(P("Key References", h1))
story.append(bullets([
"DiVito E, Lloyd A. ER:YAG laser for 3-dimensional debridement of canal systems: use of photon-induced photoacoustic streaming. Dentistry Today. 2012.",
"De Moor RJ, Meire M, Goharkhay K, et al. Efficacy of Er:YAG laser in the removal of the root canal smear layer. J Endod. 2010.",
"Olivi G, DiVito E, et al. Disinfection efficacy of photon-induced photoacoustic streaming on root canals infected with Enterococcus faecalis. J Am Dent Assoc. 2014.",
"Arslan H, Capar ID, Saygili G, et al. Effect of photon-initiated photoacoustic streaming on removal of apically placed dentinal debris. Int Endod J. 2014.",
"Laky M, Volmer M, Arslan M, et al. Efficacy and Safety of Photon Induced Photoacoustic Streaming for Removal of Calcium Hydroxide in Endodontic Treatment. BioMed Res Int. 2018.",
"Tong J, Liu L, Du J, et al. Effect of photon-induced photoacoustic streaming and shock-wave enhanced emission photoacoustic streaming on smear layer removal in curved canals. J Dent Sci. 2023.",
"Do QL, et al. The Efficiency of the Er:YAG Laser and Photon-Induced Photoacoustic Streaming (PIPS) on Endodontic Treatment: A Review. PMC7369550.",
"Mancini M, et al. Laser-activated irrigation (PIPS and SWEEPS) compared to passive ultrasonic irrigation: a review. PMC7901090.",
], style=note))

story.append(Spacer(1, 10))
story.append(P("Note: This document is an exam-style model answer synthesised for study purposes from current dental literature. Cross-check against your specific university's syllabus/marking scheme.", note))

doc = SimpleDocTemplate("/tmp/workspace/pips-endo/output/Photon_Induced_Photoacoustic_Streaming_PIPS.pdf",
                         pagesize=A4, topMargin=18*mm, bottomMargin=16*mm, leftMargin=16*mm, rightMargin=16*mm,
                         title="Photon-Induced Photoacoustic Streaming (PIPS)")
doc.build(story)
print("PDF built successfully")