Shrinking matrix boundaries

Scan Labels Around the Border

Original & variantSpiral Matrix ↗

Original examples and wording. The question below states the exact input format and output contract.

01. The question

Read a rectangular label matrix clockwise from its top-left corner, peeling one outer border at a time. Return the labels in reading order without changing the matrix.

Label sheet3 rows × 4 columns
r / c0123
02468
11357
29101112

Trace the top edge → right edge → bottom edge → left edge, then move inward.

Before revealing the idea, predict the result and describe what information you would need to track.

02. Worked example

Inputlabels = [[2,4,6,8],[1,3,5,7],[9,10,11,12]]

Output[2,4,6,8,7,12,11,10,9,1,3,5]

  1. Read the top row, then the right column downward.
  2. Read the bottom row backward, then the left edge upward.
  3. The remaining middle row contributes 3 and 5.

Try your code

Define solve(data, parameter="") and return your result. Your code runs locally, not on a server.

Edit your test cases

Use 1-10 objects with data and an optional string parameter. Expected outputs are computed from the lesson. An optional expected field must be correct.

Input contract & reference code

Example data: [[2,4,6,8],[1,3,5,7],[9,10,11,12]]. Parameter: "". Numeric parameters arrive as strings; convert them with int(parameter) when needed.

The example and generated cases use the question’s exact variant. This checks behavior on a small test batch—not performance on every possible input.

Python runtime notices

Python downloads only when you run code, using compressed runtime assets. Code is not saved or uploaded. Enable JavaScript to run it.

Five-second execution limit per batch. Standard-library Python only; additional packages and network access are unavailable. Stop ends execution without blocking the lesson.

03. The idea

Try sketching your own approach first. What would you track, and why would it work?

Reveal the idea
  1. Track top, bottom, left and right boundaries.
  2. Consume each edge, then move its boundary inward.
  3. Check boundaries before bottom and left passes to avoid duplicates.

04. Watch it happen

Use Step to move slowly, or Play to follow the whole trace. Change a preset or load your own input.

Input & settings

A rectangular 1-5 row by 1-5 column integer matrix, values -99 to 99.

Red = current item / blue = active window or cells / green = completed work. A value docks at its actual destination; the original input stays unchanged. Positions start at 0.

Working state / what changes

Ready to begin

Enable JavaScript to step through the animation. The worked example and solution below remain readable without it.

Python / why it changes

The line behind the step

def border_scan(labels):
    top, bottom = 0, len(labels) - 1
    left, right = 0, len(labels[0]) - 1
    output = []
    while top <= bottom and left <= right:
        for col in range(left, right + 1):
            output.append(labels[top][col])
        top += 1
        for row in range(top, bottom + 1):
            output.append(labels[row][right])
        right -= 1
        if top <= bottom:
            for col in range(right, left - 1, -1):
                output.append(labels[bottom][col])
            bottom -= 1
        if left <= right:
            for row in range(bottom, top - 1, -1):
                output.append(labels[row][left])
            left += 1
    return output
How to use this walkthrough

Hover or focus a control for its label. Play forms the input and follows values into the working state. Step shows one change; Back and the slider restore exact snapshots. Reduced motion uses instant updates. Saved snapshots and sorted heap displays are teaching overhead, not algorithm complexity.

05. Python solution

def border_scan(labels):
    top, bottom = 0, len(labels) - 1
    left, right = 0, len(labels[0]) - 1
    output = []
    while top <= bottom and left <= right:
        for col in range(left, right + 1):
            output.append(labels[top][col])
        top += 1
        for row in range(top, bottom + 1):
            output.append(labels[row][right])
        right -= 1
        if top <= bottom:
            for col in range(right, left - 1, -1):
                output.append(labels[bottom][col])
            bottom -= 1
        if left <= right:
            for row in range(bottom, top - 1, -1):
                output.append(labels[row][left])
            left += 1
    return output

06. Cost & edge cases

Time
O(RC)
Space
O(1) auxiliary plus O(RC) output
  • One row or column must not be read twice.
  • A nonempty rectangular matrix is required.

Keep going