[Python] functools.partial

signature

functools.partial(func, /, *args, **keywords)

• ref.: functools.partial

function 처럼 동작하는 partial object를 반환하는 High-order Function임.

• 반환되는 partaial object를 호출시 parameter로 받은 func이 호출되며
• partial object를 호출할 때 넘겨진 positional arguments args와 keyword arguments keywords가 해당 func의 argument로 주어져 호출된다.

partial object가 호출될 때

• 더 많은 arguments가 주어질 경우,
• partial object를 생성할 때 주어졌던 args와 keywords에 append되어 func에 넘겨짐.
• keyword에 따라 override가 발생할 수 도 있음.

2024.02.04 - [Python] - [Python] Parameter 의 종류 - Slash and Asterisk for Function Parameters

[Python] Parameter 의 종류 - Slash and Asterisk for Function Parameters

---

용도

동일한 arguments와 keyword arguments로 동일 함수를 여러차례 호출해야하는 경우

functools.partial을 통해 가벼운 wrapper인 partial object를 만들어 사용하는게 편함.

• 2개의 기능을 한번에 구현하고 argument를 통해 실행 기능이 결정되는 경우에,
• partial로 다른 이름의 callable object를 얻어서 사용하면 가독성 측면에서도 용이함.
• python 공식문서에서는 docstring까지 기재하는 예도 있음.

또는, optuna 에서 objective 함수와 같이 특정 argument만 전달받도록 강제된 경우에,

• 추가적인 argument를 넘겨주는 용도로도 사용됨.
• 즉 특정 framework 또는 library에서 제한된 arguments를 가지도록 된 함수에 추가적인 argument를 넘겨주는데 사용됨.

objective_with_data = partial(
    objective, 
    train_loader=train_loader,
    valid_loader=valid_loader,
)

---

예제

다음의 code snippet은 동일한 arguments를 가지는 Dense layer를 여러 개 사용하기 위해 partial을 이용하고 있음.

from functools import partial

RegularizedDense = partial(
    tf.keras.layers.Dense, 
    activation="relu",
    kernel_initializer="he_normal", 
    kernel_regularizer=tf.keras.regularizers.l2(0.01)
)

model = tf.keras.Sequential(
    [ 
        tf.keras.layers.Flatten(input_shape=[28, 28]), 
        RegularizedDense(100),
        RegularizedDense(100),
        RegularizedDense(10, activation="softmax") 
    ]
)

 

참고로 위의 코드의 출처는 다음과 같음.

https://www.oreilly.com/library/view/hands-on-machine-learning/9781492032632/

Hands-On Machine Learning with Scikit-Learn, Keras, and TensorFlow, 2nd Edition

---

같이 보면 좋은 자료들

2024.11.20 - [Python] - [Py] Higher-order Function (고차함수)

[Py] Higher-order Function (고차함수)

---