따라서 특정 Plotly 그림을 HTML 문자열로 변환해야 할 수도 있습니다.
이 튜토리얼에서는 Plotly io 모듈을 사용하여 그림을 HTML 문자열 표현으로 변환하는 방법을 배웁니다.
뛰어들어봅시다.
Plotly.io.to_html() 함수
Plotly의 io 모듈에서 to_html() 함수를 사용하면 특정 그림을 매개변수로 전달하고 HTML 문자열로 변환할 수 있습니다.
함수 구문은 다음과 같이 표현됩니다.
음모를 꾸미다. 이것 . to_html ( 무화과 , 구성 = 없음 , 자동 재생 = 진실 , include_plotlyjs = 진실 , include_mathjax = 거짓 , 추신 = 없음 , 전체_html = 진실 , animation_opts = 없음 , default_width = '100%' , default_height = '100%' , 확인 = 진실 , div_id = 없음 )
아래에서 함수 매개변수를 살펴보겠습니다.
- 그림 – 그림 개체 또는 그림의 사전 표현을 나타냅니다.
- 구성 – plotly.js 구성 옵션을 지정합니다. 구성 옵션을 사전으로 전달합니다.
- Auto_play – 페이지 로드 시 애니메이션 시퀀스가 자동으로 재생되어야 하는지 여부를 결정합니다. 이 매개변수는 애니메이션 프레임이 포함된 Figure가 있는 경우에 유용합니다.
- Include_plotlyjs – 이 매개변수는 HTML에 plotly.js 라이브러리가 포함되는 방식을 지정합니다. 이 매개변수에 허용되는 값은 다음과 같습니다.
- True – HTML 문서의 스크립트 태그로 plotly.js 라이브러리를 포함합니다. 이렇게 하면 파일 크기가 증가하지만 오프라인 환경에서 파일을 사용할 수 있습니다.
- 'cdn' – include_plotlyjs 매개변수를 'cdn'으로 설정하면 plotly.js 라이브러리에 대한 원격 링크를 가리키는 스크립트 태그가 추가됩니다. 네트워크 환경이나 파일 크기에 민감한 환경에서 이 옵션을 사용하십시오.
- '디렉토리' – HTML 문서와 동일한 디렉토리에 있는 외부 plotly.min.js 번들을 가리키는 스크립트 태그를 포함합니다.
- 'require' – 값을 require로 설정하면 require.js를 사용하여 plotly.js 라이브러리를 로드합니다. require.js가 시스템에 설치되어 전역적으로 사용 가능한지 확인하십시오.
- 'False' – plotly.js 라이브러리를 포함하지 않습니다. full_html 매개변수를 True로 설정할 때 이 값을 사용하지 마십시오. 전체 문서를 사용할 수 없게 만들 수 있습니다.
- include_mathjax – 파일에 mathjax.js 라이브러리가 포함되어야 하는지 여부를 지정합니다. 허용되는 값은 'require' 값을 제외하고는 include_plotlyjs와 유사합니다.
- Post_script – 플롯 생성 후 실행되는 JavaScript 스니펫을 포함할 수 있습니다.
- Full_html – true인 경우 함수는 태그로 시작하는 전체 HTML 문서를 포함하는 문자열을 반환합니다. false인 경우 함수는 요소로 시작하는 HTML 문자열을 반환합니다.
- Animation_opts – 사용자 정의 애니메이션 속성을 사전으로 지정할 수 있습니다. 그런 다음 이 값은 plotly.js의 plotly.animate 함수에 전달됩니다.
- Default_width – 결과 Figure의 기본 너비를 픽셀 단위로 지정합니다.
- Default_height – Figure의 기본 높이를 픽셀 단위로 지정합니다.
- Validate – HTML 문자열로 변환하기 전에 Figure의 유효성을 검사해야 하는지 여부를 결정합니다.
- Div_id – 플롯이 위치한 div 태그의 id 속성 값을 지정합니다.
그런 다음 함수는 Figure의 문자열 표현을 문자열로 반환합니다.
사용 예
다음 코드는 to_html 함수를 사용하여 Figure를 HTML 문자열 표현으로 변환하는 방법을 보여줍니다.
수입 음모를 꾸미다. 표현하다 ~처럼 픽셀
DF = 픽셀 데이터 . 주식 ( 인덱싱된 = 진실 )
무화과 = 픽셀 지역 ( DF , facet_col = '회사' , facet_col_wrap = 둘 )
무화과. 보여 주다 ( )위의 예에서는 Plotly 익스프레스 모듈을 px로 가져오는 것으로 시작합니다. 그런 다음 Plotly의 스톡 데이터를 사용하여 데이터 프레임을 만듭니다.
마지막으로 px.area 함수를 사용하여 패싯 영역 플롯을 만듭니다. 그러면 아래와 같은 그림이 반환됩니다.
위의 그림을 아래 코드와 같이 HTML 문자열 표현으로 변환할 수 있습니다.
수입 음모를 꾸미다. 이것 ~처럼 이것
이것. to_html ( 무화과 , 전체_html = 거짓 )위의 코드를 실행하면 아래 스크린샷과 같이 방대한 HTML 문자열이 반환되어야 합니다.
HTML 문서는
요소에서 시작합니다. 전체 HTML 파일을 포함하려면 다음과 같이 매개변수 full_html=True를 설정합니다. 수입 음모를 꾸미다. 이것 ~처럼 이것
이것. to_html ( 무화과 , 전체_html = 진실 )
마크업은 태그에서 시작됩니다.
plotly.js를 포함하려면 매개변수를 다음과 같이 설정할 수 있습니다.
수입 음모를 꾸미다. 이것 ~처럼 이것
이것. to_html ( 무화과 , include_plotlyjs = 'cdn' , 전체_html = 진실 )위의 예에서 우리는 CDN 링크를 통해 plotly.js 라이브러리를 포함하도록 함수에 지시합니다.
아래 출력에서 이를 확인할 수 있습니다.
to_html 문서를 사용하는 가장 좋은 방법은 HTML 문자열을 HTML 파일로 내보내는 것입니다.
아래와 같이 간단한 코드를 실행하여 이 작업을 수행할 수 있습니다.
수입 음모를 꾸미다. 이것 ~처럼 이것
~와 함께 열려 있는 ( '패싯.html' , '안에' ) ~처럼 에프:
에프. 쓰기 라인 ( 이것. to_html ( 무화과 , include_plotlyjs = 'cnd' , 전체_html = 진실 ) )이 예에서는 Python의 파일 모듈을 사용하여 HTML 문자열을 N html 파일로 작성합니다.
그런 다음 브라우저에서 HTML 문서를 열고 그림과 같이 볼 수 있습니다.
결론
축하합니다. plotly.io.to_html 함수를 사용하여 Plotly 그림을 HTML 문자열로 성공적으로 내보냈습니다.