turtle.up()

2025-06-06

Pythonのturtleモジュールにおけるturtle.up()(またはturtle.penup())は、タートルグラフィックスで描画を行う際に、ペンを上げる役割を持つコマンドです。

具体的には、以下の効果があります。

  • 位置の移動
    線を描かずにタートルを別の場所に移動させたい場合に使用します。例えば、ある図形を描き終えた後、別の場所に新しい図形を描き始めたい場合に、turtle.up()でペンを上げてから移動し、目的の場所でturtle.down()(ペンを下ろす)を実行して描画を再開します。
  • 描画の停止
    turtle.up()を実行すると、その時点からタートルが移動しても線が描かれなくなります。まるでペンが紙から離れた状態になるため、移動経路に跡が残りません。
import turtle

# タートルオブジェクトの作成
t = turtle.Turtle()

# 最初の四角形を描く
t.forward(100)
t.left(90)
t.forward(100)
t.left(90)
t.forward(100)
t.left(90)
t.forward(100)

# ペンを上げる(線を描かずに移動する準備)
t.up() # または t.penup()

# タートルを右に移動させる(線は描かれない)
t.forward(150)

# ペンを下ろす(再び線を描く準備)
t.down() # または t.pendown()

# 2番目の四角形を描く
t.forward(100)
t.left(90)
t.forward(100)
t.left(90)
t.forward(100)
t.left(90)
t.forward(100)

# 描画ウィンドウを閉じるまで待機
turtle.done()


よくあるエラーとトラブルシューティング

    • 原因
      turtleモジュールを正しくインポートしていないか、タートルオブジェクトを作成していない可能性があります。あるいは、タートルオブジェクトがNoneになってしまっている場合も考えられます。

    • import turtle
      # turtle.up() # これだとエラーになる(タートルオブジェクトがないため)
      
      t = turtle.Turtle()
      t.up() # これは正しい
      
    • トラブルシューティング
      • import turtle をコードの先頭に記述しているか確認してください。
      • turtle.Turtle() を使ってタートルオブジェクト(例: my_turtle = turtle.Turtle())を作成し、そのオブジェクトに対して.up()を呼び出しているか確認してください。
  1. turtle.up()turtle.down() の使い忘れ

    • 原因
      線を描きたくない場所を移動する際にup()を呼び出すのを忘れていたり、移動後に再び線を描きたいのにdown()を呼び出すのを忘れていたりするケースです。

    • import turtle
      t = turtle.Turtle()
      
      t.forward(100) # 線が描かれる
      
      # ここで線を引かずに移動したいのに up() を忘れた
      t.goto(50, 50) # 線が描かれてしまう
      
      t.up()
      t.goto(-50, -50) # 線は描かれない
      
      # ここからまた線を引きたいのに down() を忘れた
      t.forward(50) # 線が描かれない
      
      turtle.done()
      
    • トラブルシューティング
      • 線を描かずに移動したい区間の直前に必ずturtle.up()(またはturtle.penup())を記述します。
      • 線を描画を再開したい区間の直前に必ずturtle.down()(またはturtle.pendown())を記述します。
      • プログラムの意図する描画結果と実際の描画結果を比較し、線が引かれるべきでない場所で引かれていたり、引かれるべき場所で引かれていなかったりしないか確認します。
  2. 大文字・小文字の間違い (turtle.Up()など)

    • 原因
      Pythonは大文字と小文字を区別します。up()は小文字でなければなりません。

    • import turtle
      t = turtle.Turtle()
      # t.Up() # これはエラーになる
      t.up() # これは正しい
      
    • トラブルシューティング
      • メソッド名が正確に小文字でup()(またはpenup())と記述されているか確認してください。
  3. 括弧の欠落 (turtle.upなど)

    • 原因
      upは関数(メソッド)なので、呼び出す際には必ず括弧()が必要です。

    • import turtle
      t = turtle.Turtle()
      # t.up # これだとメソッドを呼び出していない
      t.up() # これは正しい
      
    • トラブルシューティング
      • upの後に()が付いているか確認してください。
  4. モジュールの名前空間の混同

    • 原因
      from turtle import * のようにワイルドカードインポートを使用している場合、up()を直接呼び出すことができますが、通常はimport turtleとしてturtle.up()またはタートルオブジェクト(例: t.up())を介して呼び出すのが一般的です。混同すると、どのupが呼び出されているのか混乱する場合があります。

    • # from turtle import *
      # up() # この場合は動く
      
      import turtle
      # up() # この場合はエラーになる(turtle.up() または t.up() が必要)
      
    • トラブルシューティング
      • 推奨されるのは import turtle であり、その場合、turtle.up() または タートルオブジェクト名.up() の形式で呼び出す必要があります。コード全体で一貫したインポート方法と呼び出し方法を使用してください。
  • シンプルなコードで試す
    複雑な描画プログラムの中で問題が発生した場合、turtle.up()だけを使った非常にシンプルなテストコードを作成して、単独で正しく動作するかどうかを確認します。
  • コードのステップ実行
    コードを小さな塊に区切って実行し、どこで問題が発生するかを特定します。特に、up()down()を挟む移動で意図しない描画がされた場合は、その前後の状態を確認すると良いでしょう。
  • エラーメッセージを読む
    Pythonのエラーメッセージ(Traceback)は、問題の原因と場所を特定するための重要な手がかりです。特に、AttributeErrorNameError は、オブジェクトや変数の名前、またはメソッドの呼び出し方に問題があることを示唆しています。


例1:線を引かずに移動する基本的な例

これは最も基本的な使い方で、ある場所から別の場所へ、線を描かずに移動する際に使用します。

import turtle

# 画面とタートルを準備
wn = turtle.Screen()
wn.bgcolor("lightgreen")
t = turtle.Turtle()
t.shape("turtle")
t.color("blue")
t.speed(1) # 少しゆっくりめに動くように設定

# 最初の線を引く
t.forward(100) # 前に100ピクセル進む(線が引かれる)

# ペンを上げる(これ以降は線が引かれない)
t.up() # または t.penup()

# 線を引かずに移動
t.forward(50)  # 前に50ピクセル進むが、線は引かれない
t.right(90)    # 右に90度方向転換するが、線は引かれない
t.forward(50)  # 前に50ピクセル進むが、線は引かれない

# ペンを下ろす(再び線が引かれるようになる)
t.down() # または t.pendown()

# 2番目の線を引く
t.forward(100) # 前に100ピクセル進む(線が引かれる)

# 画面が閉じられるまで待つ
wn.exitonclick()

解説

  • 最後のt.forward(100)で、2番目の線が描画されます。
  • t.down()を呼び出すと、再び線を描画できるようになります。
  • t.up()を呼び出すと、タートルは移動しても線を描かなくなります。この状態で右に曲がったり、さらに進んだりしても画面上には何も描かれません。
  • 最初にタートルが100ピクセル進み、線が描かれます。

例2:点線を描く

up()down()を短い間隔で交互に使うことで、点線(破線)のような効果を出すことができます。

import turtle

wn = turtle.Screen()
wn.bgcolor("lightblue")
t = turtle.Turtle()
t.shape("arrow")
t.color("red")
t.speed(5)

# 点線を描くループ
for _ in range(10): # 10回繰り返す
    t.down()    # ペンを下ろす(線を描く)
    t.forward(10) # 10ピクセル進む
    t.up()      # ペンを上げる(線を描かない)
    t.forward(10) # 10ピクセル進む(空白を作る)

# 画面が閉じられるまで待つ
wn.exitonclick()

解説

  • この「線を描いて、空白を作り」を繰り返すことで、点線が描かれます。
  • ループの中で、まずt.down()でペンを下ろして10ピクセル線を引き、すぐにt.up()でペンを上げてから、次の10ピクセルを進みます。

例3:複数の図形を離れた場所に描く

up()を使って、画面の異なる位置に複数の独立した図形を描画することができます。

import turtle

wn = turtle.Screen()
wn.bgcolor("white")
t = turtle.Turtle()
t.shape("circle")
t.color("purple")
t.speed(3)

# 最初の四角形を描く (中央から開始)
for _ in range(4):
    t.forward(50)
    t.left(90)

# ペンを上げて、次の開始位置へ移動
t.up()
t.goto(100, 50) # x=100, y=50 の位置へ移動
t.down() # ペンを下ろす

# 2番目の三角形を描く
t.color("green")
t.forward(60)
t.left(120)
t.forward(60)
t.left(120)
t.forward(60)

# ペンを上げて、さらに次の開始位置へ移動
t.up()
t.goto(-100, -50) # x=-100, y=-50 の位置へ移動
t.down() # ペンを下ろす

# 3番目の円を描く
t.color("blue")
t.circle(30) # 半径30の円を描く

# 画面が閉じられるまで待つ
wn.exitonclick()

解説

  • t.up()t.down()を使うことで、互いに独立した描画を画面上の好きな場所に配置できます。
  • 同様に、さらに別の場所に移動して円を描いています。
  • 新しい場所に着いたらt.down()でペンを下ろし、そこで三角形を描いています。
  • 最初の四角形を描いた後、t.up()でペンを上げてからt.goto(100, 50)でタートルを新しい座標に移動させています。この移動中には線は描かれません。

特定の模様の一部だけを描画したくない場合にもup()が役立ちます。

import turtle

wn = turtle.Screen()
wn.bgcolor("black")
t = turtle.Turtle()
t.color("yellow")
t.speed(0) # 最速

length = 1 # 線の長さの初期値

for i in range(200):
    t.forward(length)
    t.right(90) # 右に90度曲がる
    length += 1 # 次の線の長さを増やす

    # 特定の条件で描画を一時停止
    if i == 50:
        t.up() # 50回目以降はペンを上げる
    if i == 100:
        t.down() # 100回目以降はペンを下ろす

# 画面が閉じられるまで待つ
wn.exitonclick()
  • 結果として、途中に空白のあるらせんが描かれます。
  • iが100になったとき、t.down()が呼び出され、再び描画が再開されます。
  • iが50になったとき(50本目の線を描き終えた後)、t.up()が呼び出され、一時的に描画が停止します。これにより、らせんの一部が空白になります。
  • このコードは、らせん状の模様を描いています。


しかし、「線を描かずに移動する」という目的を達成するための、異なるアプローチや関連するテクニックはいくつか存在します。それらを「代替方法」として説明します。

turtle.penup() を使用する(最も一般的な代替)

これはturtle.up()と全く同じ機能を持つエイリアス(別名)です。どちらを使っても構いませんが、penup()の方がより「ペンを上げる」という意図が明確で、コードの可読性が上がると感じる人もいます。

import turtle

t = turtle.Turtle()

t.forward(50) # 線を引く

t.penup() # up() と全く同じ効果
t.forward(50) # 線を引かない

t.pendown() # down() と全く同じ効果
t.forward(50) # 線を引く

turtle.done()

turtle.setheading() や turtle.goto() などで直接移動する(描画状態は変わらない)

これは厳密にはup()の代替ではありませんが、「線を描かずに移動したい」という目的の一部を達成するために、タートルの現在の描画状態(ペンが上がっているか下がっているか)を変更せずに、タートルの位置や向きを直接設定する方法です。

  • turtle.goto(x, y) / turtle.setpos(x, y) / turtle.setposition(x, y)
    これもタートルを特定の座標に移動させるコマンドですが、ペンが下がっていれば線は引かれます。線を描かずに移動したい場合は、goto()の前にup()を呼び出すのが通常の流れです。

    import turtle
    
    t = turtle.Turtle()
    t.down() # ペンが下がっている状態
    
    t.goto(100, 0) # 線が引かれる
    
    t.up() # ここでペンを上げる
    t.goto(0, 100) # 線が引かれない
    
    turtle.done()
    
  • turtle.setx(x) / turtle.sety(y) / turtle.setheading(angle)
    これらのコマンドは、タートルを特定のX座標、Y座標、または特定の角度に設定しますが、ペンが下がっていれば線は引かれます。ペンを上げたい場合は、やはりup()が必要です。

    import turtle
    
    t = turtle.Turtle()
    t.down() # ペンが下がっている状態
    
    t.forward(100) # 線が引かれる
    
    # これらは描画状態を維持するので、ペンが下がっていれば線が引かれてしまう
    # t.setx(50)
    # t.sety(50)
    # t.setheading(45)
    
    turtle.done()
    

ポイント
setx(), sety(), setheading(), goto()などの移動系のコマンドは、それ自体がペンの上げ下げを行うわけではありません。ペンが上がっていれば線は引かれず、ペンが下がっていれば線が引かれるという、現在のペンの状態に従って動作します。そのため、これらのコマンドで線を描かずに移動したい場合は、やはり事前にup()を呼び出す必要があります。

これは代替方法というよりは、現在のペンの状態を確認するための補助的なメソッドです。複雑なプログラムで、現在のペンの状態が上がっているのか下がっているのかを条件分岐の材料にしたい場合に有用です。

  • turtle.ispenup(): ペンが上がっていればTrue、下がっていればFalseを返します。
  • turtle.isdown(): ペンが下がっていればTrue、上がっていればFalseを返します。
import turtle

t = turtle.Turtle()

print(f"初期状態(ペンは下がっている):{t.isdown()}") # True

t.up()
print(f"up()後(ペンは上がっている):{t.isdown()}") # False
print(f"up()後(ペンは上がっている):{t.ispenup()}") # True

t.down()
print(f"down()後(ペンは下がっている):{t.isdown()}") # True
print(f"down()後(ペンは下がっている):{t.ispenup()}") # False

turtle.done()
  • 「線を描かずに移動する」目的の代替
    • タートルを移動させるコマンド(forward(), backward(), goto()など)は、up()またはpenup()と組み合わせて使うことで、線を描かずに移動できます。
    • setx(), sety(), setheading()は、タートルの位置や向きを直接設定しますが、ペンの上げ下げは行わないため、線を描きたくない場合はやはりup()と組み合わせる必要があります。
  • turtle.up()の直接的な代替
    最も近いのはturtle.penup()です。機能は全く同じです。