schore 0.0.5

Core classes for scheduling problems' definition

schore

schore is a lightweight Python library providing core classes for scheduling problems.

• Parameter management: Transform tabular or textual input into structured parameters for scheduling problems.
• Schedule management: Abstract base classes for defining and managing schedule data.

✨ Modules

Data Management

from schore.data import DfManager, Table2DManager

• DfManager: Base class for managing a DataFrame.
• Table2DManager: Manages a 2D table represented as a DataFrame.

Parameter Management

from schore.parameters import JobStageProcessingTimeManager, JobMachineProcessingTimeManager

• JobStageProcessingTimeManager: Manages a 2D DataFrame with stages as columns and jobs as rows.
• JobMachineProcessingTimeManager: Manages a 2D DataFrame with machines as columns and jobs as rows.

Schedule Management

from schore.schedule.abstract import Activity, Resource, ResourceGroup, ParallelResourceGroup

• Activity: Represents a scheduled operation (in shop environments) or a job (in single/parallel machine environments).
• Resource: Represents a single resource (e.g., machine or worker).
• ResourceGroup: Manages a group of resources collectively.
• ParallelResourceGroup: Manages a group of resources that can operate in parallel.

These abstract base classes help you define, extend, and manage schedule-related data structures for various scheduling problems.

Utility

from schore.util import TextDataParser

• TextDataParser: Parses text data from a stream.

Visualization

from schore import GanttPlotter

• GanttPlotter: General-purpose Gantt chart plotter for schedule visualization.
  • Supports group/resource/activity color modes.
  • Configurable layout, legend, and figure sizing.

Examples

from schore.parameters_examples.parallel_shop.identical_flow import HybridFlowshopParameters

• HybridFlowshopParameters: Parameter class for a hybrid flowshop with identical parallel machines at each stage.

🧪 Testing

To run the tests, use the following command:

pytest tests/

Installation

pip:

pip install schore

If you use uv as your Python package manager:

uv add schore

🛠️ Repository Structure

├── src/
│   └── schore/
│       ├── data/
│       │   ├── df_manager.py
│       │   └── table_2d_manager.py
│       ├── gantt_plotter.py
│       ├── parameters/
│       │   └── processing_time/
│       │       ├── job_mc_p.py
│       │       └── job_stage_p.py
│       ├── parameters_examples/
│       │   ├── parallel/
│       │   ├── parallel_shop/
│       │   │   └── identical_flow/
│       │   │       └── hybrid_flowshop.py
│       │   ├── shop/
│       │   │   └── flow/
│       │   │       ├── flowshop.py
│       │   │       └── flowshop_duedate.py
│       │   └── single/
│       ├── schedule/
│       │   └── abstract/
│       │       ├── activity.py
│       │       ├── resource.py
│       │       ├── resource_group.py
│       │       └── parallel_resource_group.py
│       ├── schedule_examples/
│       │   ├── machine.py
│       │   ├── parallel/
│       │   ├── parallel_shop/
│       │   │   └── identical_flow/
│       │   │       ├── hybrid_flowshop_operation.py
│       │   │       ├── hybrid_flowshop_machine.py
│       │   │       ├── hybrid_flowshop_stage.py
│       │   │       └── hybrid_flowshop_schedule.py
│       │   ├── shop/
│       │   │   └── flow/
│       │   │       ├── flowshop_operation.py
│       │   │       ├── flowshop_schedule.py
│       │   │       └── flowshop_stage.py
│       │   └── single/
│       ├── util/
│       │   └── text_data_parser.py
│       ├── type_aliases.py
│       └── type_defs.py
├── tests/
│   ├── data/
│   │   ├── test_df_manager.py
│   │   └── test_table_2d_manager.py
│   ├── examples/
│   │   ├── parallel_shop/
│   │   │   └── test_hybrid_flowshop.py
│   │   └── shop/
│   │       └── flow/
│   │           └── test_flowshop_duedate.py
│   ├── manager/
│   │   ├── test_job_machine_processing_time_manager.py
│   │   └── test_job_stage_processing_time_manager.py
│   ├── schedule/
│   │   └── abstract/
│   │       ├── test_activity.py
│   │       └── test_resource.py
│   ├── schedule_examples/
│   │   ├── parallel_shop/
│   │   │   └── identical_flow/
│   │   │       └── test_hybrid_flowshop_schedule.py
│   │   └── shop/
│   │       └── flow/
│   │           └── test_hybrid_flowshop_schedule.py
│   └── util/
│       └── test_text_data_parser.py

License

This project is licensed under the MIT License. See the LICENSE file for details.