sciris 3.2.6__tar.gz → 3.2.9__tar.gz

sciris-3.2.9/.claude-plugin/marketplace.json

@@ -0,0 +1,18 @@
+{
+  "name": "sciris-marketplace",
+  "owner": {
+    "name": "Sciris"
+  },
+  "metadata": {
+    "description": "Sciris skills for Claude Code"
+  },
+  "plugins": [
+    {
+      "name": "sciris",
+      "source": "./claude_plugin",
+      "description": "Skills covering all Sciris features: arrays, dicts, files, plotting, parallelization, dates, printing, utilities, and advanced features",
+      "version": "0.1.0",
+      "keywords": ["sciris", "scientific-python"]
+    }
+  ]
+}

{sciris-3.2.6 → sciris-3.2.9}/.github/workflows/schedule_tests.yaml

@@ -1,8 +1,9 @@
 name: Sciris cron tests
 on:
+  workflow_call:
   workflow_dispatch:
   schedule:
-    - cron: "0 0 * * 0" # Run every Sunday at midnight
+    - cron: "0 0 * * *" # Run every day at midnight
 
 jobs:
   ci-tests:

{sciris-3.2.6 → sciris-3.2.9}/.github/workflows/test_downstream.yaml

@@ -1,6 +1,7 @@
 name: Sciris downstream tests
 on:
   workflow_dispatch:
+  workflow_call:
   push:
     branches:
       - main

{sciris-3.2.6 → sciris-3.2.9}/.github/workflows/test_sciris.yaml

@@ -1,6 +1,7 @@
 name: Sciris CI tests
 on:
   workflow_dispatch:
+  workflow_call:
   pull_request:
 
 jobs:

{sciris-3.2.6 → sciris-3.2.9}/CHANGELOG.rst

@@ -7,6 +7,21 @@ All major updates to Sciris are documented here.
 
 By import convention, components of the Sciris library are listed beginning with ``sc.``, e.g. ``sc.odict()``.
 
+Version 3.2.9 (2026-03-06)
+--------------------------
+#. Allowed ``verbose=0`` in :func:`sc.loadbalancer() <sc_parallel.loadbalancer>`.
+#. Allowed :func:`sc.makefilepath() <sc_fileio.makefilepath>` to create folders when no filename is specified.
+#. Added a Claude Code plugin: install by adding https://github.com/sciris/sciris as a marketplace.
+
+Version 3.2.8 (2026-02-28)
+--------------------------
+#. Changed resolution order in :class:`sc.objdict() <sc_odict.objdict>` so that dunder attributes (e.g. ``__await__``) are never accidentally set as dict keys. Attempting to set an existing attribute as a key now raises ``KeyError`` instead of ``ValueError``.
+#. Fixed a bug in :class:`sc.profile() <sc_profiling.profile>` that prevented profiling information from being printed for certain combinations of filenames.
+
+Version 3.2.7 (2026-02-18)
+--------------------------
+#. Refactored :class:`sc.asd() <sc_asd.asd>` to be more robust to different parameter inputs and different objective function return values.
+
 Version 3.2.6 (2026-02-12)
 --------------------------
 #. Added :class:`sc.argparse() <sc_odict.argparse>`, a simple argument parser based on ``sc.objdict``.

{sciris-3.2.6 → sciris-3.2.9}/CLAUDE.md

@@ -66,6 +66,38 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 - **Downstream tests:** `.github/workflows/test_downstream.yaml` (tests dependent packages)
 - **Release workflow:** `.github/workflows/pypi_release.yaml` (automated PyPI publishing)
 
+## Claude Code Plugin
+
+Sciris includes a Claude Code skills plugin in `claude_plugin/` that provides domain-specific skills for working with Sciris. The plugin is registered via `.claude-plugin/marketplace.json`.
+
+### Installation
+Users can install the plugin by adding `https://github.com/sciris/sciris` as a Claude Code marketplace (see `/install-plugin`).
+
+### Available Skills
+The plugin provides 10 skills covering all major Sciris domains:
+- **sciris-intro** - Basic Sciris features and quick reference
+- **sciris-arrays** - Array operations (`sc.findinds()`, `sc.findnearest()`, `sc.toarray()`, etc.)
+- **sciris-dicts** - Containers (`sc.odict()`, `sc.objdict()`, `sc.counter()`, etc.)
+- **sciris-files** - File I/O (`sc.save()`, `sc.load()`, `sc.savejson()`, etc.)
+- **sciris-plotting** - Matplotlib extensions (`sc.boxoff()`, `sc.dateformatter()`, etc.)
+- **sciris-parallel** - Parallelization (`sc.parallelize()`, `sc.loadbalancer()`)
+- **sciris-dates** - Date/time handling (`sc.date()`, `sc.daterange()`, `sc.timer()`)
+- **sciris-printing** - Printing and formatting (`sc.heading()`, `sc.sigfig()`, `sc.progressbar()`)
+- **sciris-utils** - Utilities (`sc.mergedicts()`, `sc.tryexcept()`, `sc.checkmem()`, etc.)
+- **sciris-advanced** - Advanced features (`sc.odict` subclassing, nested operations, versioning)
+
+### MCP Servers
+The plugin also configures Context7 and GitMCP servers for accessing up-to-date Sciris documentation.
+
+### Plugin Structure
+```
+claude_plugin/
+  .claude-plugin/plugin.json    # Plugin manifest
+  skills/                       # Skill definitions (one SKILL.md per skill)
+.claude-plugin/
+  marketplace.json              # Marketplace registration
+```
+
 ## Architecture Overview
 
 Sciris is a scientific Python utilities library with a modular design organized around functional domains. Published in the Journal of Open Source Software (JOSS), Sciris aims to streamline the development of scientific software by making it easier to perform common tasks through "simplifying interfaces" that reduce boilerplate code and focus on scientific clarity.

{sciris-3.2.6/sciris.egg-info → sciris-3.2.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sciris
-Version: 3.2.6
+Version: 3.2.9
 Summary: Fast, flexible tools to simplify scientific Python
 Author-email: Sciris Development Team <info@sciris.org>
 License-Expression: MIT
@@ -79,7 +79,13 @@ Using conda: ``conda install -c conda-forge sciris``
 
 Using uv: ``uv add sciris``
 
-*Requires Python >= 3.7*.
+*Requires Python >= 3.9*.
+
+
+AI integration
+--------------
+
+Sciris has MCP servers on `Context 7 <https://context7.com/sciris/sciris>`_ and `GitMCP <https://gitmcp.io/sciris/sciris>`_. It also has a Claude Code plugin: to install, add this repository (https://github.com/sciris/sciris) to the Claude Code marketplace and from there install the plugin.
 
 
 Tests

{sciris-3.2.6 → sciris-3.2.9}/README.rst

@@ -33,7 +33,13 @@ Using conda: ``conda install -c conda-forge sciris``
 
 Using uv: ``uv add sciris``
 
-*Requires Python >= 3.7*.
+*Requires Python >= 3.9*.
+
+
+AI integration
+--------------
+
+Sciris has MCP servers on `Context 7 <https://context7.com/sciris/sciris>`_ and `GitMCP <https://gitmcp.io/sciris/sciris>`_. It also has a Claude Code plugin: to install, add this repository (https://github.com/sciris/sciris) to the Claude Code marketplace and from there install the plugin.
 
 
 Tests

sciris-3.2.9/claude_plugin/.claude-plugin/plugin.json

@@ -0,0 +1,21 @@
+{
+  "name": "sciris",
+  "version": "0.1.0",
+  "description": "Claude skills for Sciris features covering arrays, containers, file I/O, plotting, parallelization, dates, printing, utilities, and advanced features",
+  "author": {
+    "name": "Sciris"
+  },
+  "repository": "https://github.com/sciris/sciris",
+  "license": "MIT",
+  "keywords": ["sciris", "scientific-python"],
+  "mcpServers": {
+    "context7": {
+      "type": "http",
+      "url": "https://mcp.context7.com/mcp"
+    },
+    "gitmcp": {
+      "type": "http",
+      "url": "https://gitmcp.io/sciris/sciris"
+    }
+  }
+}

sciris-3.2.9/claude_plugin/README.md

@@ -0,0 +1,58 @@
+# Sciris Claude Code Plugin
+
+This folder contains a [Claude Code](https://docs.anthropic.com/en/docs/claude-code) skills plugin that helps Claude work more effectively with [Sciris](https://sciris.org).
+
+## What it does
+
+The plugin provides Claude with domain-specific knowledge about Sciris features, organized into focused skills. When you ask Claude to help with Sciris code, these skills give it detailed guidance on the right functions, patterns, and idioms to use.
+
+The plugin also configures MCP servers ([Context7](https://context7.com) and [GitMCP](https://gitmcp.io)) so Claude can look up current Sciris documentation on the fly.
+
+## Installation
+
+In Claude Code, add the Sciris repository as a marketplace:
+
+```
+/install-plugin https://github.com/sciris/sciris
+```
+
+Or manually add `https://github.com/sciris/sciris` as a marketplace in your Claude Code settings.
+
+## Available skills
+
+| Skill | Description |
+|-------|-------------|
+| **sciris-intro** | Basic Sciris features and quick reference |
+| **sciris-arrays** | Array operations (`sc.findinds`, `sc.findnearest`, `sc.toarray`, etc.) |
+| **sciris-dicts** | Containers (`sc.odict`, `sc.objdict`, `sc.counter`, etc.) |
+| **sciris-files** | File I/O (`sc.save`, `sc.load`, `sc.savejson`, etc.) |
+| **sciris-plotting** | Matplotlib extensions (`sc.boxoff`, `sc.dateformatter`, etc.) |
+| **sciris-parallel** | Parallelization (`sc.parallelize`, `sc.loadbalancer`) |
+| **sciris-dates** | Date/time handling (`sc.date`, `sc.daterange`, `sc.timer`) |
+| **sciris-printing** | Printing and formatting (`sc.heading`, `sc.sigfig`, `sc.progressbar`) |
+| **sciris-utils** | Utilities (`sc.mergedicts`, `sc.tryexcept`, `sc.checkmem`, etc.) |
+| **sciris-advanced** | Advanced features (`sc.odict` subclassing, nested operations, versioning) |
+
+## Organization
+
+```
+claude_plugin/
+├── README.md                          # This file
+├── .claude-plugin/
+│   └── plugin.json                    # Plugin manifest (name, MCP servers, metadata)
+└── skills/
+    ├── sciris-intro/SKILL.md
+    ├── sciris-arrays/SKILL.md
+    ├── sciris-dicts/SKILL.md
+    ├── sciris-files/SKILL.md
+    ├── sciris-plotting/SKILL.md
+    ├── sciris-parallel/SKILL.md
+    ├── sciris-dates/SKILL.md
+    ├── sciris-printing/SKILL.md
+    ├── sciris-utils/SKILL.md
+    └── sciris-advanced/SKILL.md
+```
+
+Each skill is a single `SKILL.md` file with YAML frontmatter (name and description for triggering) followed by markdown content with usage examples and API guidance.
+
+The marketplace registration file at `.claude-plugin/marketplace.json` (in the repo root) points to this folder.

sciris-3.2.9/claude_plugin/skills/sciris-advanced/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: sciris-advanced
+description: Use when working with advanced Sciris features — nested dictionaries (sc.makenested, sc.getnested, sc.setnested, sc.iternested, sc.search, sc.iterobj), context blocks (sc.capture, sc.tryexcept), sc.smoothinterp interpolation, sc.asd optimization, sc.animation, sc.savemovie, or sc.printjson.
+---
+
+# Sciris Advanced Features
+
+Reference for nested dicts, context blocks, interpolation, optimization, and animation. See full tutorial: `docs/tutorials/tut_advanced.ipynb`.
+
+If you need more detail, use your MCP tools (Context7 or GitMCP) to look up current Sciris documentation, or consult the other Sciris skills.
+
+## Nested Dictionaries
+
+```python
+nest = {}
+sc.makenested(nest, ['key1', 'key1.1'])     # Create nested structure
+sc.makenested(nest, ['key2', 'key2.1', 'key2.1.1'])
+
+# Iterate over all "twigs" (leaf paths)
+for twig in sc.iternested(nest):
+    sc.setnested(nest, twig, value)          # Set value at path
+    val = sc.getnested(nest, twig)           # Get value at path
+
+# Search by key or value
+sc.search(nest, 'key2.1.1')                 # Find by key pattern
+sc.search(nest, value=5)                    # Find by value
+
+# Transform all values
+sc.iterobj(nest, transform_func, inplace=True)
+
+sc.printjson(nest)                           # Pretty-print as JSON
+```
+
+## Context Blocks
+
+### Capture output
+```python
+with sc.capture() as text:
+    verbose_function()                       # All print output → text variable
+lines = text.splitlines()
+```
+
+### Exception handling
+```python
+# Simple: exit gracefully at first exception
+with sc.tryexcept():
+    risky_function()
+
+# Advanced: accumulate exception history
+tryexc = None
+for i in range(1000):
+    with sc.tryexcept(history=tryexc, verbose=False) as tryexc:
+        fickle_function()
+tryexc.disp()                                # Show all exceptions
+```
+
+## Interpolation
+
+```python
+# Smoother than np.interp, more conservative than scipy cubic spline
+y_new = sc.smoothinterp(newx, origx, origy, smoothness=5)
+```
+
+## Optimization (Adaptive Stochastic Descent)
+
+```python
+result = sc.asd(objective_func, x0, verbose=False)
+# Often faster and more accurate than scipy.optimize.minimize for noisy problems
+```
+
+## Animation
+
+```python
+frames = [plt.plot(np.cumsum(np.random.randn(100))) for i in range(20)]
+sc.savemovie(frames, 'animation.gif')
+```

sciris-3.2.9/claude_plugin/skills/sciris-arrays/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: sciris-arrays
+description: Use when working with NumPy arrays in Sciris — finding indices, nearest values, concatenation, handling NaN/missing values, smoothing data, 2D Gaussian smoothing, or linear regression with sc.findinds, sc.findnearest, sc.cat, sc.rmnans, sc.fillnans, sc.smooth, sc.rolling, sc.linregress.
+---
+
+# Sciris Math and Array Tools
+
+Reference for array utilities that simplify NumPy workflows. See full tutorial: `docs/tutorials/tut_arrays.ipynb`.
+
+If you need more detail, use your MCP tools (Context7 or GitMCP) to look up current Sciris documentation, or consult the other Sciris skills.
+
+## Array Indexing
+
+```python
+import numpy as np
+import sciris as sc
+
+data = np.random.rand(100)
+
+# Find indices where condition is true
+inds = sc.findinds(data > 0.9)           # vs (data>0.9).nonzero()[0]
+
+# Find nearest value
+ind = sc.findnearest(data, 0.5)          # vs np.argmin(abs(data - 0.5))
+
+# Works on lists too (not just arrays)
+ind = sc.findnearest([81, 78, 66, 25], 50)
+```
+
+## Creating/Concatenating Arrays
+
+```python
+sc.cat(1, 2, 3)                          # array([1, 2, 3])
+
+# Add row to matrix — vs np.concatenate([data, np.atleast_2d(np.array([1,2]))])
+data = sc.cat(data, [1, 2])
+```
+
+## Missing Values
+
+```python
+d0 = [1, 2, np.nan, 4, np.nan, 6, np.nan, np.nan, np.nan, 10]
+
+d1 = sc.rmnans(d0)                       # Remove NaNs
+d2 = sc.fillnans(d0, 0)                  # Replace with zeros
+d3 = sc.fillnans(d0, 'linear')           # Linear interpolation
+```
+
+## Smoothing
+
+```python
+# 1D smoothing
+smooth = sc.smooth(data, 7)              # Gaussian-like smoothing
+roll = sc.rolling(data, 7)               # Rolling average
+
+# 2D Gaussian smoothing
+smooth2d = sc.gauss2d(raw_2d, scale=2)
+```
+
+## Other Math
+
+```python
+# Random rounding: 0.7 rounds up 70% of the time
+rounded = sc.randround(data)
+
+# Linear regression
+m, b = sc.linregress(x, y)
+
+# 3D plotting helpers
+ax = sc.ax3d(121)                        # Create 3D subplot
+sc.bar3d(data, ax=ax)                    # 3D bar plot
+```

sciris-3.2.9/claude_plugin/skills/sciris-dates/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: sciris-dates
+description: Use when working with dates, times, or timing in Sciris — sc.timer, sc.tic, sc.toc, sc.date, sc.daterange, sc.datedelta, sc.now, sc.getdate, sc.time, sc.timedsleep, sc.randsleep, date format conversion, or timing code blocks.
+---
+
+# Sciris Dates and Times
+
+Reference for timing and date utilities. See full tutorial: `docs/tutorials/tut_dates.ipynb`.
+
+If you need more detail, use your MCP tools (Context7 or GitMCP) to look up current Sciris documentation, or consult the other Sciris skills.
+
+## Timing Code
+
+### Timer object
+```python
+T = sc.timer()
+
+zeros = np.zeros((n, n))
+T.tt('Make zeros')          # toc-then-tic (prints elapsed, resets)
+
+rand = np.random.rand(n, n)
+T.tt('Make random')
+```
+
+### Context manager
+```python
+with sc.timer('My operation'):
+    expensive_work()
+```
+
+### Timer statistics
+```python
+T = sc.timer()
+for i in range(10):
+    work(i)
+    T.tt(f'Iteration {i}')
+
+print(T.mean(), T.std(), T.min(), T.max())
+T.plot()                    # Plot timing results
+```
+
+## Sleep Utilities
+
+```python
+sc.timedsleep(0.3)                  # Like time.sleep()
+
+# In a loop: accounts for computation time so each iteration = exact duration
+for i in range(5):
+    sc.timedsleep('start')
+    do_work()
+    sc.timedsleep(0.3, verbose=True)  # Total iteration = 0.3s
+
+sc.randsleep(0.2)                    # Sleep random 0-0.4s (mean 0.2)
+```
+
+## Date Utilities
+
+### Current time
+```python
+sc.time()                # Unix timestamp (time.time())
+sc.now()                 # datetime.datetime.now()
+sc.getdate()             # Formatted string: '2024-Mar-15 14:30:00'
+```
+
+### Date conversion
+```python
+sc.date('2022-03-04')                        # str → datetime
+sc.date('04-03-2022', format='mdy')          # Explicit format
+sc.date('04-03-2022', format='dmy')          # Day-month-year
+```
+
+### Date ranges and math
+```python
+dates = sc.daterange('2022-02-02', '2022-03-04')          # List of date strings
+dates = sc.daterange('2022-01-01', '2022-12-31', as_date=True)  # As datetime objects
+newdates = sc.datedelta(dates, months=10)                  # Add 10 months
+```

sciris-3.2.9/claude_plugin/skills/sciris-dicts/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: sciris-dicts
+description: Use when working with Sciris dictionaries or dataframes — sc.odict, sc.objdict, sc.dataframe, integer indexing of dicts, enumitems, object-syntax access, dataframe creation with dtypes, appendrow, or sc.dataframe.cat.
+---
+
+# Sciris Dictionaries and Dataframes
+
+Reference for Sciris container types. See full tutorial: `docs/tutorials/tut_dicts.ipynb`.
+
+If you need more detail, use your MCP tools (Context7 or GitMCP) to look up current Sciris documentation, or consult the other Sciris skills.
+
+## odict — Ordered Dict with Index Access
+
+```python
+od = sc.odict(a=['some', 'strings'], b=[1, 2, 3])
+
+od['a']                  # Key access (like dict)
+od[0]                    # Integer index access
+od.keys()[0]             # Keys returns a list (not dict_keys)
+
+for i, k, v in od.enumitems():   # Enumerate with key and value
+    print(f'Item {i}: {k} = {v}')
+```
+
+**When NOT to use odict:** When your dict has integer keys (ambiguous with index access).
+
+**odict vs objdict:** odict is slightly faster (nanoseconds per op). Use odict for millions of operations; objdict for everything else.
+
+## objdict — odict + Object Syntax
+
+```python
+ob = sc.objdict(key1=[1, 2], key2=[3, 4])
+
+ob.key1                  # Object syntax (no quotes!)
+ob['key1']               # Dict syntax
+ob[0]                    # Index syntax
+# All three are equivalent
+
+# Especially handy in f-strings:
+print(f'{ob.key1 = }')  # No nested quote issues
+```
+
+## dataframe — Enhanced pd.DataFrame
+
+### Creation shortcuts
+```python
+# Simpler than pd.DataFrame(dict(x=x, y=y, z=z))
+df = sc.dataframe(x=x, y=y, z=z)
+
+# With dtypes
+df = sc.dataframe(x=x, y=y, z=z, dtypes=[str, float, bool])
+
+# Columns with types
+df = sc.dataframe(columns=dict(x=str, y=float, z=bool), data=data)
+```
+
+### Display
+```python
+df.disp()                               # Show full dataframe (no truncation)
+df.disp(precision=1, ncols=5, nrows=10) # Customized display
+```
+
+### Indexing
+```python
+df['values', 1]          # Column + row access
+df[1]                    # Auto iloc fallback (KeyError in pandas)
+```
+
+### In-place manipulation
+```python
+df.appendrow(['d', 4, 0])               # Append row in-place
+
+# Concatenate anything
+df = sc.dataframe.cat(
+    sc.dataframe(x=['a'], y=[1]),        # Dataframe
+    dict(x=['b'], y=[2]),                # Dict
+    [['c', 3]],                          # Raw data
+)
+```

sciris-3.2.9/claude_plugin/skills/sciris-files/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: sciris-files
+description: Use when saving or loading files with Sciris — sc.save, sc.load, sc.savejson, sc.loadjson, sc.saveyaml, sc.readyaml, sc.savearchive, sc.loadarchive, sc.savefig, sc.loadmetadata, sc.getfilelist, sc.thispath, sc.makefilepath, sc.rmpath, sc.metadata, sc.compareversions, sc.require, or version/reproducibility tracking.
+---
+
+# Sciris Files and Versioning
+
+Reference for file I/O and version management. See full tutorial: `docs/tutorials/tut_files.ipynb`.
+
+If you need more detail, use your MCP tools (Context7 or GitMCP) to look up current Sciris documentation, or consult the other Sciris skills.
+
+## Save/Load Any Object
+
+```python
+sc.save('my-sim.obj', sim)           # Gzipped pickle (works with any Python object)
+sim = sc.load('my-sim.obj')          # Load — methods and class still work
+sc.zsave('fast.obj', sim)            # Zstandard compression (slightly faster)
+# sc.load() auto-detects compression format
+```
+
+## JSON
+
+```python
+sc.savejson('data.json', obj)        # Saves JSONifiable parts of any object
+data = sc.loadjson('data.json')      # Returns dict (not original object)
+data = sc.readjson(json_string)      # Parse JSON from string
+```
+
+## YAML (JSON superset with comments)
+
+```python
+data = sc.readyaml(yaml_string)      # Parse YAML (supports comments)
+sc.saveyaml('config.yaml', data)
+```
+
+## File Utilities
+
+```python
+sc.getfilelist('*.ipynb')            # List files matching pattern
+sc.thispath()                        # Path of current file (use instead of pathlib.Path)
+sc.makefilepath('data/out.csv', makedirs=True)  # Ensure path exists
+sc.rmpath('file_or_folder')         # Remove file or folder (auto-detects)
+```
+
+## Versioning and Reproducibility
+
+```python
+md = sc.metadata()                   # Collect all environment metadata
+sc.compareversions(np, '>1.0')       # Version comparison (returns True/False)
+sc.require('numpy>1.20')            # Warn/raise if requirement not met
+```
+
+### Metadata-enhanced figures
+```python
+sc.savefig('fig.png', comments='My analysis')  # Saves with metadata (use instead of plt.savefig)
+md = sc.loadmetadata('fig.png')                # Retrieve metadata later
+```
+
+### Metadata-enhanced archives
+```python
+sc.savearchive('sim.zip', sim, files='script.py', comments='Full run')
+sim = sc.loadarchive('sim.zip')      # Restore object
+md = sc.loadmetadata('sim.zip')      # Get metadata separately
+```

sciris-3.2.9/claude_plugin/skills/sciris-intro/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: sciris-intro
+description: Use when the user needs to implement a basic Sciris features — finding array values, plotting with date formatting, objdict containers, saving/loading objects, or parallelization.
+---
+
+# Sciris introduction
+
+Quick reference for Sciris' most commonly used features. See the full tutorial: `docs/tutorials/tut_intro.ipynb`.
+
+If you need more detail, use your MCP tools (Context7 or GitMCP) to look up current Sciris documentation, or consult the other Sciris skills.
+
+## Core Patterns
+
+### Array operations
+Use the `sciris-arrays` skill for more details.
+```python
+import numpy as np
+import sciris as sc
+
+data = np.random.rand(50)
+inds = sc.findinds(data > 0.9)          # Find indices matching condition
+mean_str = sc.arraymean(data)            # Mean ± std as string
+joined = sc.strjoin(inds)               # Join values into comma-separated string
+```
+
+### Quick plotting with dates
+Use the `sciris-dates` skill for more details.
+```python
+dates = sc.daterange('2022-01-01', '2022-02-28', as_date=True)
+values = 1e6 * np.random.randn(59)**2
+
+data = sc.dataframe(x=dates, y=values)  # Shortcut to pd.DataFrame
+plt.scatter(data.x, data.y)
+sc.dateformatter()                       # Format date axis
+sc.SIticks()                             # SI notation on y-axis
+```
+
+### Flexible containers
+Use the `sciris-dicts` skill for more details.
+```python
+data = sc.objdict(a=[1,2,3], b=[4,5,6])
+assert data.a == data['a'] == data[0]    # Three ways to access
+assert data[:].sum() == 21              # Slice and sum
+for i, key, value in data.enumitems():   # Enumerate with keys
+    print(f'Item {i}: {key} = {value}')
+```
+
+### Save/load any object
+Use the `sciris-files` skill for more details.
+```python
+sc.save('my-sim.obj', sim)               # Save (gzipped pickle)
+new_sim = sc.load('my-sim.obj')          # Load — methods still work!
+new_sim.plot()
+```
+
+### Parallelization
+Use the `sciris-parallel` skill for more details.
+```python
+results = sc.parallelize(func, iterkwargs=dict(scale=[40,30,20,10]), x_offset=5, y_offset=10)
+```
+
+### Plot configuration
+Use the `sciris-plotting` skill for more details.
+```python
+sc.options(dpi=120, jupyter=True)        # Set DPI and backend
+sc.boxoff()                              # Remove top/right spines
+```