diff --git a/README.md b/README.md index 0f9cc0b..4dfd375 100644 --- a/README.md +++ b/README.md @@ -45,3 +45,20 @@ Thank you all the special people that invested their time and knowledge to impro We appreciate if one or more of the following references can be added in your projects due to the usage of `asltk` outcomes. * Paper 1 + +## Quick Assistance + +Need help with basic ASL data processing? + +Check out our new guide: +[QUICK ASSISTANCE](docs/quick_assistance.md) + +It includes ready-to-use code for: +- Loading/saving ASL images +- Changing PLD/LD parameters +- Creating CBF maps +- Generating T1-BLG mappings +- Logging and debugging + +Perfect for beginners or quick reference during prototyping. + diff --git a/docs/quick_assistance.md b/docs/quick_assistance.md new file mode 100644 index 0000000..d3381f9 --- /dev/null +++ b/docs/quick_assistance.md @@ -0,0 +1,70 @@ +# **Quick Assistance** + +This section provides minimal examples of common tasks in `asltk`, to help new users get started quickly. + +Each snippet includes links to full guides and deeper usage in the rest of the documentation. + +--- + +## Load and Save an ASL Image + +```python +from asltk.io import load_asl, save_asl + +asl_data = load_asl("input_asl.nii.gz") +save_asl(asl_data, "output_asl.nii.gz") +``` +* Related: [Examples](docs/usage_examples.md), [Getting started](docs/getting_started.md) +--- +## Modify Parameters of an ASL Image +```python +from asltk.io import load_asl + +asl_data = load_asl("image.nii.gz") +asl_data.pld_values = [1.5] # Update post-label delay +asl_data.ld_values = [1.8] # Update label duration +``` +--- +## Copy an ASL Dataset +```python +from copy import deepcopy +from asltk.io import load_asl + +asl_data = load_asl("scan.nii.gz") +asl_copy = deepcopy(asl_data) +``` +--- +## Create T1-BLG Map from MultiTE-ASL +```python +from asltk.io import load_asl +from asltk.multite import generate_t1blgm_map + +multi_te_asl = load_asl("multite_asl.nii.gz") +t1blgm_map = generate_t1blgm_map(multi_te_asl) +``` +* see also: [usage examples](usage_examples.md) +--- +## Modify Parameters Before Reconstruction +```python +from asltk.io import load_asl +from asltk.recon import CBFReconstruction + +asl_data = load_asl("input_asl.nii.gz") +asl_data.pld_values = [2.0] +asl_data.ld_values = [1.5] + +cbf = CBFReconstruction() +cbf_map = cbf.run(asl_data) +``` +--- +## Add Logging to a Script +```python +from asltk import setup_logging, get_logger + +setup_logging(level="INFO", console_output=True) +logger = get_logger() +logger.info("Starting ASL processing...") +``` +* See: [logging](logging.md) +* full logging guide: [logging](logging.md) +---