text-wordclouds
Use AutoViz text-column cleaning and wordcloud behavior for NLP-style tabular fields.
- License 许可
- Apache-2.0
- 最近更新
- 2026-09-03
- Stars
- ★ 351
- Forks
- 27
01 前言 Front Matter
- name
- text-wordclouds
- license
- Apache 2.0
- metadata
- { "disco-role": "operating" }
- description
- Use AutoViz text-column cleaning and wordcloud behavior for NLP-style tabular fields.
- disable-model-invocation
- true
02 资源文件 3
- 参考文档references/troubleshooting.md1.2 KB
- 参考文档references/workflows.md1.3 KB
- 脚本scripts/wordcloud_smoke.py1.4 KB
03 SKILL.md 正文
Text Wordclouds
Use this sub-skill when the user asks about AutoViz behavior for string columns, discrete text columns, NLP variables, wordcloud plots, text cleanup, emoji handling, stopwords, or NLTK downloads.
Use this when
- The prompt names
wordcloud,AutoViz_NLP,draw_word_clouds,nltk,textblob,emoji, stopwords, contractions, or text cleanup. - AutoViz detects string variables and attempts to generate wordclouds.
- The user needs to understand why a text column did or did not get a wordcloud.
- The user is debugging missing NLTK data, missing
wordcloud, or text preprocessing side effects. - The user wants to know how AutoViz distinguishes categorical strings from NLP-style strings.
Core flow
- Start from the DataFrame and identify candidate string columns.
- Let AutoViz classify variables first; only discrete/NLP string variables reach the wordcloud branch.
- For each selected string column, AutoViz cleans text and calls wordcloud generation.
- If a target column is present and the problem type is classification, wordclouds may be drawn per target class.
- Use static chart formats for deterministic automated runs; interactive behavior is covered by the EDA sub-skill.
- When the user only needs text preprocessing, explain the cleanup helpers without forcing a full AutoViz run.
Read these references
references/workflows.md: text-cleaning and wordcloud-generation behavior.references/troubleshooting.md: NLTK, wordcloud, and string-column classification issues.../../references/api-reference.md: signatures for text helper functions anddraw_word_clouds.../eda-visualization/references/workflows.md: how text columns fit into the full AutoViz run.../../references/install-and-compatibility.md: package-version checks if the text branch breaks at import time.
Use these scripts
- Run
scripts/wordcloud_smoke.pyto verify that thewordcloudpackage and AutoViz text helper path can run on a safe in-memory DataFrame. - If the text branch is failing inside a larger EDA run, use the EDA smoke script first and then return here.
Important behavior
- AutoViz may call
nltk.download('popular')when discrete string variables are present. - Short or low-cardinality strings may be classified as categorical/boolean rather than NLP.
- Very high-cardinality or long free-text columns are more likely to trigger wordcloud behavior.
draw_word_cloudsdepends on matplotlib plus thewordcloudpackage.- The text helpers also perform cleanup such as URL, HTML, emoji, contraction, and punctuation handling.
Common text helpers
clean_stepsclean_textremove_URLremove_htmlremove_emojiexpandContractionsremove_stopwordssplit_into_lemmasdraw_wordcloud_from_dataframe
Cross-routing
- If the user primarily wants full-table EDA plots, route to
../eda-visualization/SKILL.md. - If the user asks whether a text column should be cleaned or repaired before modeling, route to
../data-quality-fixes/SKILL.mdand return here for visualization-specific text behavior. - Do not rely on source notebooks or the original checkout; use the bundled references and script.
- If the user needs to know whether NLTK data will be downloaded, mention it explicitly before running the workflow.
Troubleshooting reminders
- If the column never reaches the wordcloud branch, the classifier likely treated it as categorical or boolean.
- If
nltk.download('popular')is a problem, prepare the corpora or choose a static EDA path that does not trigger text plotting. - If the output is empty or tiny, the text may have been over-cleaned or reduced to stopwords.
- Use a writable
save_plot_dirwhen saving images so the generated wordcloud is easy to find.
Escalation
If the user really wants a full EDA view of the same dataframe, route back to the EDA sub-skill after handling the text question. If the data-quality question is about missingness or cleaning rather than visualization, route to the data-quality sub-skill instead of over-focusing on wordclouds.
04 同仓库更多 Skills
passnet-triton-opt
Make a single PassNet Triton kernel fast AND numerically faithful: performance model (when a replacement can win at all), block/grid/warp tuning, autotune policy, launch overhead, and per-op numeric recipes to pass the dtype baseline tolerances. Use when a pass matches and is correct but speedup below expected, or when correctness fails by small numeric margins.
passnet-solve
END-TO-END playbook for solving one PassNet sample: analyze the computation graphs, decide the optimization strategy (what to fuse, what to replace, what to leave alone), drive the iteration loop, and maximize the sample score. This is the ENTRY skill — invoke it first for any PassNet optimization task; it tells you when to use passnet-pattern-fusion, passnet-triton-opt and passnet-feedback.
passnet-skill
PassNet GPU kernel optimization via compiler passes. Design and implement Triton-based optimization passes, create pass files under ./pass_dir/, self-evaluate with pass_evaluator, and iterate to maximize GPU speedup.
passnet-pattern-fusion
Author PassNet pass files: write patterns that actually MATCH the FX graph, pick fusion regions (which ops to absorb into one Triton kernel), and structure multi-pass submissions with the mandatory shared-dispatch architecture. Use when creating or fixing pattern()/replacement_args()/replacement_func() files, when a pass "failed to match", or when deciding how to fuse multiple kernels/ops.
passnet-orchestrate
Round/batch planning and decision support for PassNet graph optimization. Use for multi-sample triage, worker allocation, eval-budget policy, and post-eval keep/revert decisions. For solving one concrete sample end to end, use passnet-solve as the entry skill; consult this skill only when you need broader planning or a specific decision gate.
passnet-feedback
Fast, deterministic feedback for PassNet work: pre-flight pattern/match verification WITHOUT burning a GPU evaluation, per-node bottleneck analysis of a sample's graphs, and eval-log parsing into per-variant status + estimated score + failure classification. Use BEFORE every GPU evaluation (check_pattern), at the START of a sample (analyze_graph), and AFTER every evaluation (parse_eval_log).